Textube - YouTube Subtitle Extractor

A Chrome extension that extracts subtitles from YouTube videos with a local Python server.

Latest: v2.1 — URL入力欄からの取得 / プロンプトをUIから編集

Features

• 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
• Copy to clipboard with one click
• Copy with AI summarization prompt
• Download as text file
• Server auto-starts on Windows boot

Architecture

[Chrome Extension] <--HTTP--> [Local Python Server] <--API--> [YouTube]
     (popup)                    (localhost:5000)

Requirements

• Windows 10/11
• Python 3.12+
• Google Chrome

Installation

1. Install Python

Download from python.org

Important: Check "Add Python to PATH" during installation

2. Install Textube

1. Download ZIP from Releases
2. 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

3. Load Chrome Extension

1. Open Chrome and go to chrome://extensions
2. Enable "Developer mode" (top right)
3. Click "Load unpacked"
4. Select the extension folder

Usage

A. YouTubeページで取得（既存）

1. Open a YouTube video
2. Click the Textube icon in Chrome toolbar
3. Click "Extract Subtitles"
4. Choose an action:
   • Copy - Copy subtitles to clipboard
   • Copy with Prompt - Copy with AI summarization prompt
   • Download - Save as text file

B. URL入力で取得（v2.1〜）

YouTubeページにいなくても字幕取得できる。

1. 任意のページでTextubeアイコンをクリック
2. 「URLから取得（任意）」欄に YouTube URL または 11桁の動画IDを貼り付け
3. 緑のヒント「動画ID: xxxxxxxxxxx」が出ればOK
4. 「Extract Subtitles」をクリック

URL欄に何か入力されている場合は URL欄の動画が優先される（タブの動画ではなく）。

Customization

プロンプトの編集（v2.1〜）

「Copy with Prompt」で挿入される要約プロンプトをUIから編集できる。

1. popup右下の ⚙ボタン をクリック
2. モーダルでプロンプトを編集
3. ボタン操作：
   • 保存 — 編集内容を保存（次回以降も有効）
   • 初期値に戻す — 編集欄を初期プロンプトに戻す（保存はまだ）
   • キャンセル — 変更を破棄して閉じる

保存先は chrome.storage.local（拡張内ストレージ）。プロファイル単位で永続化される。

Uninstall

1. Run uninstall.bat
2. Remove extension from chrome://extensions
3. Delete the folder

Troubleshooting

Issue	Solution
Server offline	Run install.bat again
No subtitles found	Video may not have captions
Python not found	Install Python with PATH option

Tech Stack

• Extension: Chrome Manifest V3, Vanilla JS
• Server: Python, Flask, youtube-transcript-api
• Auto-start: VBScript + Windows Startup folder

関連プロジェクト

🖥 Textube_app

履歴管理・サムネ表示・動画ダウンロード(1080p)・翻訳まで含む デスクトップアプリ版 (PyQt5)。 本格的に字幕を活用したい人向け。

👉 最新リリース: v2.1.0 をダウンロード（Windows用 exe バンドル zip）

License

MIT