videohub-youtube

# VideoHub Media Processing 复用 `F:/work/VideoHub/src/youtube_transcriber.py` 的 CLI；当前 CLI 入口在文件末尾的 `if __name__ == "__main__"`。 ## 适用场景 - 处理 YouTube URL - 批量处理多个 URL - 转写本地音频 / 视频 - 从文本直接生成总结 - 生成字幕、翻译字幕、烧录字幕 - 选择字幕目标语言 - 查看模板、历史记录、清理工作目录 ## 常用命令 ```bash python src/youtube_transcriber.py --youtube "<url>" python src/youtube_transcriber.py --youtube "<url>" --generate-subtitles python src/youtube_transcriber.py --youtube "<url>" --generate-subtitles --target-language ja python src/youtube_transcriber.py --youtube "<url>" --download-video --embed-subtitles python src/youtube_transcriber.py --audio "path/to/file.mp3" python src/youtube_transcriber.py --video "path/to/file.mp4" --generate-subtitles python src/youtube_transcriber.py --video "path/to/file.mp4" --generate-subtitles --target-language ko python src/youtube_transcriber.py --video "path/to/series" --generate-subtitles python src/youtube_transcriber.py --video "path/to/file.mp4" --generate-subtitles --series-project python src/youtube_transcriber.py --text "path/to/file.txt" python src/youtube_transcriber.py --urls "<url1>" "<url2>" python src/youtube_transcriber.py --history python src/youtube_transcriber.py --cleanup-preview ``` ## 重要参数 - `--youtube` / `--audio` / `--video` / `--text` / `--batch` / `--urls` - `--generate-subtitles` - `--no-translate` - `--target-language`：支持 `zh-CN`、`zh-TW`、`en`、`ja`、`ko`、`ru`、`fr`、`de`、`es`、`it`、`pt`、`ar`，默认 `zh-CN` - `--embed-subtitles` - `--download-video` - `--transcribe-only` - `--template` / `--create-template` / `--list-templates` ## 注意 - 这是当前最强的执行型 skill，优先走现有 CLI。 - 对需要登录的 YouTube 内容，可使用 `--cookies`。 - 输出目录遵循 `paths_config.py` 下的 workspace 结构。 - 字幕翻译默认使用 Google；Google 失败时会尝试 DeepSeek/OpenAI 备用翻译。中文目标语言可选 DeepSeek 润色。 - 本地 GUI 里还有“提取本地视频音频到 songs 目录”的功能，对应 `extract_audio_from_local_videos()`，不属于当前 CLI 的主参数。 - 本地目录输入会作为剧集项目处理，在视频目录内建立 `subtitles/`、`transcripts/`、 `summaries/`、`audio/`、`videos_with_subtitles/` 和 `videohub_project.json`。后续故事剪辑或 影视解说只需接收该目录并读取项目清单。