slug: video-to-bilingual-srt version: 1.0.0 displayName: 影片雙語字幕提取 name: video-to-bilingual-srt summary: 從影片中提取雙語字幕：下載→提取音訊→Whisper識別→生成SRT。免費本地執行。 description: 支援從影片URL或本地檔案中提取音訊，用faster-whisper本地識別語音，自動生成純中文/純英文/雙語SRT字幕檔案和JSON結構化資料。無需API Key，全本地執行。 tags: - 字幕 - SRT - Whisper - 語音識別 - 影片處理 license: MIT

影片雙語字幕提取

從影片中提取音訊，用 Whisper 語音識別，自動生成 SRT 字幕檔案。

免費使用 · 無需 API Key · 全本地執行

功能概述

輸出 4 種格式： - subtitles_en.srt — 純英文 - subtitles_cn.srt — 純中文 - subtitles_bilingual.srt — 中英雙語（上英下中） - subtitles.json — JSON 結構化資料

環境依賴

安裝命令

7w4.net小蔥技能。

# 1. 安裝 ffmpeg
winget install --id Gyan.FFmpeg -e --accept-source-agreements --accept-package-agreements

# 2. 重新整理 PATH（裝完 ffmpeg 後必須）
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

# 3. 安裝 faster-whisper
pip install faster-whisper

AI 執行規範

工作流程

1. 下載影片（如提供的是 URL）→ 儲存到 %TEMP%
2. 提取音訊 → ffmpeg 轉 16kHz 單聲道 WAV
3. 語音識別 → faster-whisper base 模型，自動檢測語言
4. 翻譯（可選） → 非中文內容翻譯為中文，輸出雙語
5. 生成字幕 → SRT（utf-8-sig 編碼）+ JSON
6. 儲存 → 使用者指定目錄

步驟詳解

詳見 references/workflow.md

關鍵規則

• 始終在 Python 環境變數中設定 HF_ENDPOINT=https://hf-mirror.com 走國內映象
• SRT 檔案必須用 utf-8-sig 編碼（帶 BOM），否則部分軟體識別中文會亂碼
• ffmpeg 音訊引數固定：-vn -acodec pcm_s16le -ar 16000 -ac 1
• 首次執行會自動下載 base 模型（~145MB），後續直接使用快取
• 模型選擇：短內容用 tiny，一般用 base，高精度用 small

安全邊界

• 僅從使用者指定的 URL 下載影片
• 所有識別本地執行，不上傳資料到外部
• 臨時檔案用完即刪

這是一個實用的影片字幕提取工具，能自動從影片生成中英雙語字幕。優點是免費本地執行、隱私安全、操作流程清晰。不足之處在於後設資料配置存在問題，且缺少實際可執行的程式碼檔案，無法直接使用。如果你需要批次處理影片字幕，這是個不錯的思路，但目前還無法開箱即用。