
YouTubeの文字起こしをダウンロード
Prosey は、YouTube の動画の文字起こしをダウンロードして表示する CLI ツールです。何時間も無駄にすることなく、探している情報を手に入れられます。
主なユースケースは次のとおりです:
どちらの用途も、システム上に AI アシスタントが必要です (デフォルト: opencode。prosey config で独自のものを設定できます)。
システム上にシンタックスハイライターが検出されると、見やすい色付きの出力が得られます。
Prosey はネイティブの json 形式をそのまま出力または保存することもできます。
| 機能 | 説明 |
|---|---|
| 💡 要約 | 動画の文字起こしを取得して要約する |
| 📖 読む | 文字起こしを取得し、Markdown で整形して表示する |
| 💬 コピー | 要約をクリップボードにコピーし、Web チャットに貼り付けられるようにする |
| 📋 文字起こし ダウンロード | YouTube の文字起こしをプレーンテキストまたは JSON としてそのまま取得する |
| 🤖 AI 要約 | 文字起こしを任意の AI エージェント (opencode、Claude、Copilot、Codex) にパイプする |
| 🎨 スマート ページャー | bat、glow、mdcat がインストールされていれば自動でシンタックスハイライト (独自のページャーも設定可能) |
| 🛠️ カスタマイズ | prosey config で設定にアクセス・編集したり、プロンプトをカスタマイズしたりできる |
| 💾 ディスク キャッシュ | 文字起こしと要約はディスクにキャッシュされ、即座に再読できる |
| 📄 対応 フォーマット | プレーンテキストと JSON |
npx ですぐに試せます:
npx @tacone/prosey 771PQEDeRmw
npx @tacone/prosey https://youtu.be/771PQEDeRmw --lang es -o transcript.txt
お気に入りのパッケージマネージャーでグローバルにインストールします:
npm install -g @tacone/prosey
# or
yarn global add @tacone/prosey
# or
pnpm add -g @tacone/prosey
# or
bun install -g @tacone/prosey
Then use it anywhere:
prosey 771PQEDeRmw
開発には Bun を使用します — スクリプト、パッケージ管理、 および TypeScript ソースを直接実行します。
git clone https://github.com/tacone/prosey.git
cd prosey
bun install
bun run start -- 771PQEDeRmw
prosey [options] <video controls-url-or-id>
prosey read [options] <video controls-url-or-id>
prosey info [options] <video controls-url-or-id>
prosey summarize [options] <video controls-url-or-id>
prosey copy [--question <text>] <folder>
prosey index
prosey render
prosey config
prosey help
summarize はデフォルトのコマンドであるため、prosey <id> を実行すると AI 要約ツールが実行されます。
prosey read <id> を使用すると、整形された文字起こしをダウンロードして表示します。
summarize コマンドは文字起こしを取得し、[summarize] 設定セクションのプロンプトを先頭に付加して、その結果を設定された AI コマンドにパイプで渡します。
read コマンドは文字起こしをダウンロードし、stdout に出力します(プレーンテキスト、markdown、または JSON)。AI による処理が不要な場合に便利です。
info コマンドは動画のメタデータ(タイトル、チャンネル、再生時間、再生回数)を表示します。
index コマンドはドキュメントインデックスを再構築し、ブラウザで開きます。
インデックスにはデータディレクトリに保存されているすべての要約と文字起こしが一覧表示され、summarize/transcribe を実行するたびに自動的に再構築されます。任意のコンテンツページで Prosey ロゴをクリックすると、インデックスに戻ります。
render コマンドはキャッシュされた markdown からすべての HTML ページを再生成し(ネットワークや AI 処理は行いません)、インデックスを書き換えます。
copy コマンドはドキュメントの要約をクリップボードにコピーし、Web チャットに貼り付けられる状態にします。直前の実行の最後に表示されたフォルダ名(またはフルパス)を引数に取ります。--question を指定すると、要約の後に空行 2 つで区切って質問が追加されます。コピーできるのは要約のみです — 文字起こしのみのフォルダはエラーになります。
要約ページのメタ行には、読了時間の右側に Copy リンクがあります。これをクリックすると要約がクリップボードにコピーされ、Web チャットに貼り付けられる状態になります。
config コマンドは設定ファイルを $EDITOR で開いて編集します。接続できるターミナルがない場合 — $EDITOR が設定されていない、または stdout/stdin がパイプされている場合 — は、代わりに設定ファイルのパスが表示されます。
help コマンドは --help と同じヘルプメッセージを表示します。
# Summarize (AI summary + formatting + syntax highlighting)
prosey 771PQEDeRmw
# Summarize (same as above)
prosey summarize 771PQEDeRmw
# Transcribe (AI summary + formatting + syntax highlighting)
prosey read 771PQEDeRmw
# Show video metadata
prosey info 771PQEDeRmw
# Edit config in $EDITOR
prosey config
# List available languages
prosey read https://youtu.be/771PQEDeRmw --list
# Specify language
prosey read https://youtu.be/771PQEDeRmw --lang es
# Display JSON (no AI transcription)
prosey read 771PQEDeRmw
# Display plain text (no AI transcription)
prosey read 771PQEDeRmw
# Save transcript to file
prosey read 771PQEDeRmw -o transcript.txt
| フラグ | 説明 |
|---|---|
--lang <code> | 言語コード(例: en、fr)。省略時は自動検出されます。 |
-t, --timestamps | テキスト出力の各行の先頭に [MM:SS] を付加します。 |
--list | 動画で利用可能なトランスクリプト言語を一覧表示して終了します。 |
-o, --output <path> | 出力を stdout ではなくファイルに書き込みます。 |
--json | トランスクリプトを JSON 配列として出力します。各項目には text、offset(秒)、duration、timestamp が含まれます。 |
--text | プレーンテキストとして出力します(prosey read のデフォルト)。 |
--details | トランスクリプトの先頭に動画の詳細(タイトル、チャンネル、再生時間、再生回数、説明)を付加します(デフォルト)。 |
--no-details | 動画の詳細を抑制し、トランスクリプトのみを出力します。 |
--no-decode-entities | 生の HTML エンティティ(例: ')を保持します。テキストモードではデフォルトでデコードされます。 |
--question <text> | コピー時に要約へ質問を追加します。 |
--no-cache | キャッシュの読み取りをスキップし、強制的に新規取得します。 |
--no-format | summarize 出力に対する prettier の markdown フォーマットをスキップします。 |
-q, --quiet | すべての stderr ログを抑制します。 |
-v, --verbose | デバッグ情報を stderr に出力します。 |
--no-pager | stdout 出力のページャーを無効にします(デフォルトでは自動検出)。 |
--pager | stdout 出力にページャーを使用します(デフォルト)。 |
--reset-config | 設定ファイルをデフォルトにリセットして終了します。 |
--help | ヘルプメッセージを表示して終了します。 |
--version | バージョン番号を表示して終了します。 |
--json を使用すると、出力はオブジェクトの配列になります:
[
{
"text": "♪ We're no strangers to love ♪",
"offset": 18.64,
"duration": 3.24,
"timestamp": "00:18"
}
]
timestamp は JSON モードでは常に存在します。JSON は構造化データであるため、動画の詳細は(暗黙的に)抑制されます。
このプロジェクトでは開発に Bun を使用しています。
bun run typecheck # TypeScript check
bun run start # Run the CLI from source
bun run test # Run unit tests
bun run build # Compile Node bundle to bin/prosey
npm に公開する前に、prepack フックを介して bun run build が自動的に実行され、bin/prosey に Node 互換の JS バンドルが生成されます。
Prosey は TOML ファイルから設定を読み込みます。場所は
XDG Base Directory Specification
(~/.config/prosey/config.toml) に従いますが、PROSEY_CONFIG_PATH
環境変数を設定してカスタムパスを使用することもできます。
設定ファイルは初回実行時にデフォルト値で自動的に作成されます。
--reset-config を使用すると、いつでもデフォルトに戻すことができます。