A Chrome extension that extracts subtitles from YouTube videos with a local Python server.
Latest: v2.2.2 — 自動起動修復手順を追記
- トラブルシューティング追記:
install.batのスタートアップ登録が silent に失敗していた場合の復旧手順を README に追加。setup_autostart_fixed.ps1を PowerShell で実行すればTextube_Server.lnkがスタートアップフォルダに作成され、再起動後も自動でサーバーが立ち上がる - 動作未変更: サーバー / Extension 本体のロジックに変更なし(v2.2.1 と同等)
- Firefox Cookie を優先使用: Cookie試行順を Firefox → Brave → Chrome → なし に変更。Brave使用中(DBロック中)でも Firefox Cookie で字幕取得できる
- Deno PATH 自動設定: サーバー起動時に
~/.deno/binを PATH へ追加。yt-dlp が JS challenge を自動解決できる player_client: default: yt-dlp のデフォルト設定に委ねることで最適なクライアント(tv_downgraded等)が自動選択される- Cookie ファイル共有: デスクトップ版 Textube_app の
cookies/youtube_cookies.txtを自動参照 restart_server.bat追加: ポート5000のサーバーをワンクリックで再起動できる BAT ファイル
- yt-dlp + ブラウザCookie フォールバック: youtube-transcript-api が IPブロックされた場合に yt-dlp(Firefox → Brave → Chrome → なし の順で Cookie を試行)で突破
- HTTP 429 修正: 字幕URLのダウンロードを Cookie なし素 request から yt-dlp の
urlopen(Cookie付き)に変更。英語など非日本語字幕で発生していた 429 を解消 - 言語フォールバック修正: 英語など希望言語がない動画でも利用可能な言語に自動フォールバック(従来は「字幕なし」と誤判定していた)
- デフォルト言語の変更方法: UIに言語選択はないが、
server/server.pyの先頭付近DEFAULT_LANG = 'ja'を編集すれば取得優先言語を変更できる
- Extract subtitles from any YouTube video with captions
- Extract from any page via URL input — YouTubeページに居なくても、URLか動画IDを貼り付ければ字幕取得 (v2.1)
- Editable summarization prompt — popup右下の⚙ボタンから編集・保存・初期化 (v2.1)
- Auto-detect subtitle language (default: Japanese — change
DEFAULT_LANGinserver/server.py) - Copy to clipboard with one click
- Copy with AI summarization prompt
- Download as text file
- Server auto-starts on Windows boot
[Chrome Extension] <--HTTP--> [Local Python Server] <--API--> [YouTube]
(popup) (localhost:5000)
- Windows 10/11
- Python 3.12+
- Google Chrome
Download from python.org
Important: Check "Add Python to PATH" during installation
- Download ZIP from Releases
- Extract and double-click
install.bat
This will:
- Install Python dependencies (Flask, youtube-transcript-api)
- Register server for auto-startup
- Start the server in background
- Open Chrome and go to
chrome://extensions - Enable "Developer mode" (top right)
- Click "Load unpacked"
- Select the
extensionfolder
- Open a YouTube video
- Click the Textube icon in Chrome toolbar
- Click "Extract Subtitles"
- Choose an action:
- Copy - Copy subtitles to clipboard
- Copy with Prompt - Copy with AI summarization prompt
- Download - Save as text file
YouTubeページにいなくても字幕取得できる。
- 任意のページでTextubeアイコンをクリック
- 「URLから取得(任意)」欄に YouTube URL または 11桁の動画IDを貼り付け
- 緑のヒント「動画ID: xxxxxxxxxxx」が出ればOK
- 「Extract Subtitles」をクリック
URL欄に何か入力されている場合は URL欄の動画が優先される(タブの動画ではなく)。
「Copy with Prompt」で挿入される要約プロンプトをUIから編集できる。
- popup右下の ⚙ボタン をクリック
- モーダルでプロンプトを編集
- ボタン操作:
- 保存 — 編集内容を保存(次回以降も有効)
- 初期値に戻す — 編集欄を初期プロンプトに戻す(保存はまだ)
- キャンセル — 変更を破棄して閉じる
保存先は chrome.storage.local(拡張内ストレージ)。プロファイル単位で永続化される。
- Run
uninstall.bat - Remove extension from
chrome://extensions - Delete the folder
| Issue | Solution |
|---|---|
| Server offline | Double-click restart_server.bat |
| 再起動後に毎回 Server offline になる | 自動起動が登録されていない。下記「自動起動が効かない場合」を実行 |
| "Sign in to confirm you're not a bot" | Firefox を起動した状態で restart_server.bat を実行(Firefox Cookie を使用) |
| No subtitles found | Video may not have captions |
| Python not found | Install Python with PATH option |
install.bat のスタートアップ登録は silent に失敗することがある(>nul 2>&1 で握りつぶしている)。
スタートアップ フォルダに Textube_Server.lnk がない場合、PowerShell で次を実行する:
powershell -ExecutionPolicy Bypass -File ".\setup_autostart_fixed.ps1"Textube_Server.lnk が %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\ に作成され、次回 Windows 起動時から自動でサーバーが立ち上がる。
すぐにサーバーを起動するときは続けて restart_server.bat をダブルクリック。
- Extension: Chrome Manifest V3, Vanilla JS
- Server: Python, Flask, youtube-transcript-api
- Auto-start: VBScript + Windows Startup folder
MIT