AnIntellectualBeing/GTA-Auto-Clipper
多媒体与设计在本地录制 GTA 直播流,自动挑选高能时刻并渲染带弹出字幕的 9:16 竖屏短片。
项目介绍
GTA Auto Clipper 是一套在本地运行的 Python 工作流:抓取 GTA 游戏直播,给片段打分,再渲染出带烧录弹出字幕的竖屏短片。它先在 YouTube 直播结果中搜索 GTA 6 这类关键词,要求你亲眼看画面确认是真实游戏内容,然后以滚动分块方式录制,默认按直播聊天反应排序高能时刻;聊天不可用或某个分块没有消息时,自动退回到音频和语音打分。每个片段会从检测到的高光时刻前几秒开始,默认提前 6 秒。
渲染默认用游戏画面铺满 9:16 画布,并按帧检测人脸,把裁剪区域从固定侧边摄像头移开;也可以用 fit 模式保留完整画面、用模糊背景填充。字幕是每行最多 3 个单词的短句,放在可见游戏画面下三分之一处:每个词说出时以黄色弹出,之前的词变白,下一句在原位置替换上一句。英语语音出英文字幕,印地语出罗马化 Hinglish,其他或无法确定的语言不加字幕。脏话和性相关词汇在字幕中打码,原声保持不变。
快速使用
准备 Python 3.10+、PATH 中的 FFmpeg,以及 Node.js 或 Deno(yt-dlp 读取 YouTube 需要 JavaScript 运行时,Deno 缺失时会自动用 Node)。--crop 人脸检测需要 OpenCV,首次运行下载语音模型需要稳定网络。在 PowerShell 中:
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
直播搜索和可选的聊天打分需要 YouTube Data API 密钥,设置在终端环境变量中,不要写进文件:
$env:YOUTUBE_API_KEY = "YOUR_YOUTUBE_DATA_API_KEY"
python find_streams.py "GTA 6" --max 25 --json
搜索结果按 viewCount 排序,并不代表实时观众排名;打开候选直播并确认画面里确实是游戏内容后,再启动录制,按 Ctrl+C 停止:
python clip.py "https://www.youtube.com/watch?v=VIDEO_ID" --gameplay-confirmed --max-seconds 0 --clip-len 30 --lead-in 6 --top 2
选中的高光会以 MP4 和 JSON 元数据写入 output/。建议先用本地视频测试,测试输出到 test_out/ 且不能发布:
python clip.py --file "C:\videos\gameplay.mp4" --test --clip-len 30
常用参数包括 --moment-source(chat、combined 或 audio)、--layout(fill 铺满 9:16,或 fit 放在模糊背景上)、--spoken-language、--chunk、--min-score 和 --output-dir,详见 README。
排期发布
发布与剪辑分离,走 Zernio。先把 YouTube 账号和 Instagram Creator 或 Business 账号连接到 Zernio,再以私有环境变量设置 ZERNIO_API_KEY、ZERNIO_YOUTUBE_ACCOUNT_ID 和 ZERNIO_INSTAGRAM_ACCOUNT_ID。审核片段后,把元数据标为 "approved": true 并预览排期:
python zernio_publish.py "output\gta-CLIP-ID" --scheduled-for "2026-11-18T12:00:00+05:30"
这次试运行不会发送任何内容;加上 --publish 才会排期到两个账号。无人值守发布还需要设置 GTA_UNATTENDED_POSTS=1 并加上 --unattended。Zernio 已接受的排期可以在电脑休眠时发布,但发现直播和渲染仍需一台醒着且联网的机器。发布脚本会把 post ID 和幂等键写进元数据;API 调用失败时先检查 Zernio 后台再重试。publish.py 接受同样参数,并额外支持 PUBLISH_* 变量名;需要向多个频道分发时可用 GTA Auto Sender。
使用约束
素材权利和平台规则由使用者负责:项目没有创作者白名单,录制、剪辑和发布前需自行取得授权。这是独立粉丝项目,与 Rockstar Games、Take-Two、YouTube、Instagram、Meta、Zernio 均无隶属关系。YouTube 搜索按观看数返回候选,并不提供经过核验的实时观众排行。
直播录制必须显式带上 --gameplay-confirmed。字幕只覆盖英语和印地语(输出为 Hinglish),其他语言会生成不带字幕的片段。聊天打分需要 YouTube API 密钥,音频和语音打分则可无密钥运行。多路直播、多 Agent 的配置见 docs/MULTI-AGENT.md;可选的 AI 工作流指南与提示词包是单独产品,提示词文件见 GTA-CLIPPING-PROMPT.txt,详细流程见 AI_WORKFLOW.md。代码采用 MIT 许可证。
HotRepo 点评
该项目在 2026-11-20 进入 HotRepo 新项目榜,04:46 至 06:16 UTC 约 90 分钟内新增 7 颗 Star、4 个 Fork,累计达到 107 Star 和 41 Fork。对一个小工具来说,Fork 与 Star 的比例偏高,说明不少人直接取走副本改造,而不只是点星。它没有记录到全语言 GitHub 日榜名次。
它的设计把差异点放在打分回退(先聊天,再音频和语音)和字幕位置上,而发布环节刻意拆到 Zernio 之后、并默认先试运行。这种分离适合单路直播、单人操作的工作流;多频道使用则明确指向配套的分发项目。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- Bodila51/gtavi-claudecode把 GTA 6 直播和视频剪成竖屏短片,并对照悬赏规则检查成片的 Claude Code 插件。
- haziqahmedqasmi/PeakCut自托管把长视频和直播切成带字幕的竖屏切片,AI 选段使用自己的密钥。
- gothamor/gta-vcs-recomp用自己手上的 PS2 光盘镜像,把《GTA:罪恶都市传奇》的 PS2 可执行文件重编译成 Windows、Linux 与 macOS 原生版本。
- c22dev/muguet把 GTA V 的网页版构建当作原生应用跑在 Apple Silicon 的 Mac 和 iOS 上,并附带小型 UDP 联机。
- 0marContreras/gta6recomp一个面向《GTA VI》PC 版的实验性着色器与流式加载优化框架,目前只有说明文档。