showcase-video 面向游戏模组作者,目标是把模组做成一段 30 秒内可展示的短视频。整套工具链由 um win record(录制)、um video contact(查看)、um video compile(剪辑)组成,底层使用 ffmpeg 与 Pillow。
用途 用于录制并剪辑游戏模组的展示视频,或把多段素材拼成合集,成品可直接发布到 X/YouTube。
主要能力
- 录制:um win record --exe Game.exe --out C:\caps\take1 --seconds 40 会生成 take1.mkv、take1.audio.raw、take1.json。视频使用 ffmpeg gfxcapture 只捕获该窗口(GPU 帧,不含桌面),可用 NVENC、AMF 或 QSV 编码;NVENC H.264 最大宽度 4096 px,超过时录制器会缩放,32:9 屏幕可用 --crop 裁出中间 16:9。音频使用 WASAPI 进程回环(um/ps1/ProcLoopback.ps1)只录游戏 PID 的声音,不含其他应用与通知,并带时间戳。
- 定位与对齐:um video first-frame 找出游戏开始的位置(跳过加载画面);um video mux 将视频、音频与 json 合成为 mp4,可用 --offset 微调音画同步。
- 预览挑选:um video probe 查看片段信息;um video contact 生成带时间戳的缩略图网格(如 --every 1.5 --cols 6,或指定 --start/--end),据此确定入点出点。
- 剪辑:um video compile edl.json out.mp4,--preview 以半尺寸快速渲染。EDL 为 JSON,可设置 size、fps、theme.accent、transition(fade、pixelize 等 ffmpeg xfade 类型或 cut)、clip_volume、music(路径与音量)、watermark(路径、高度、角落)、segments(每段含 clip、in、dur、hook、title、transition,或 card 字幕卡)。
- 其他:非 16:9 片段可用 fill: blur/crop/pad;每段可设 speed、volume、zoom、crop;音乐可用 um fal music 生成,设置 bpm 或用 beats 按节拍剪辑,um video beats 可估算速度与第一拍。
使用方式 先让拍摄可重复:用模组侧时间线或命令序列脚本化动作,每次拍摄前用 um backup 恢复干净世界,隐藏调试文字、固定镜头缩放、隐藏光标(capture_cursor=0)。然后录制窗口与游戏音频,查看缩略图挑选高光时刻,写入 EDL,最后用 compile 输出。模组内也可启停录制以获得帧精确素材,停止 ffmpeg 时不要阻塞游戏主线程(先发 q,再在别的线程等待),并写成 .mkv 以便录制器被杀时文件仍可播放。
适用场景 游戏模组展示视频、片段合集、发布到 X/YouTube 的短视频。
限制与注意事项 资料未提供该工具的收费、价格、支持平台范围等信息。剪辑他人片段时需在画面与帖子中标注每位创作者(credit: "@handle"),推广用途需征得许可,不得暗示其片段由本工具制作,只下载公开帖子且仅使用所需内容。发布前建议先看成品视频的缩略图网格。