VideoSize Composer 是一个便携式桌面批量视频编码器。它使用 Tauri v2、React、TypeScript 和 Rust 构建,提供紧凑的液态玻璃工作台,用于导入媒体、配置当前任务并批量压缩视频。
以下截图来自当前开发版界面,素材保存在 assets/readme/:
- 添加媒体 — 选择视频、导入文件夹或序列帧媒体,或直接拖放文件;支持批量任务。
- 选择输出 — 为当前任务选择预设、编码格式、分辨率、画质、色彩和输出命名策略。
- 开始压缩 — 查看预计大小、剩余时间和任务详情;编码完成、失败或取消都会进入明确的终态。
2026v12-05:双击中间队列中的素材(或右键“编辑素材”)打开紧凑的临时编辑窗,使用统一画面预览、可拖拽裁切框、四边像素裁切和时间轴入出点,单独设置画幅、居中片段与 LUT。裁切时直接拖框,完成后显示处理效果;调整画幅或 LUT 时自动更新同一预览区。编辑窗的配色和控件跟随应用主题,支持深浅配色;标题、工具栏和设置区收紧,为画面保留更多空间。应用后参与导出,取消不保存修改;源文件保持原样。全景视频(含 INSV)锁定完整画幅并禁用裁切,仍可截取片段与预览 LUT;设置中可检测、自动搜索本机 SDK/ZIP、检查官方包并下载配置。官方未公开完整包时提供账号申请/下载入口,也支持官方 HTTPS ZIP 直链。- 输出支持 MP3(320 kbps),可从带音轨的视频、音频或已附加外接音频的素材导出;片段入出点同样生效。
- 支持 H.264、H.265/HEVC、AV1 和 ProRes 422 LT;支持源分辨率、短边分辨率、10%–90% 倍率缩放和自定义宽高。
- 输出帧率默认保持源帧率,也可统一为常见帧率(23.976/24/25/29.97/30/50/59.94/60)或输入自定义值。
- 支持从文件夹或任意一帧识别序列帧媒体,并可逐序列设置帧率、分辨率和像素宽幅放大率。
- 输出封装默认保持源后缀(序列帧默认 MP4),也可选择 MP4、MOV、AVI、MKV、WebM、M4V、M4A、WAV 或 MP3。
- 支持 8/10-bit、4:2:0/4:2:2,以及 SDR、HLG 和 HDR10 色彩模式。
- 通过 FFmpeg
zscale完成 HDR/SDR 像素转换并写入匹配的色彩元数据;HDR 转换和 4:2:2 使用 CPU 路径以提高可预测性。 - HLG→SDR 默认“自动”色调映射:按源亮度元数据与有限关键帧抽样,在直映射和软膝压缩高光之间选择,也可手动固定为直映射、软膝或硬截顶。抽样可取消;抽样不完整时使用软膝,有限抽样可能漏掉短暂高光。
- 未写色彩元数据的宽色域 10-bit 素材标记为「HDR(未标注)」并在任务详情提供「源色彩解释」(自动 / SDR / HLG / HDR10),确认前始终按 SDR 编码,避免误判导致画面变灰或变暗。
- Dolby Vision 保留模式使用无损 HEVC stream copy 保留已有 RPU;该模式不允许缩放或 LUT 处理,也不会生成新的 Dolby Vision 元数据。
- 可导入
.cube、.3dl和.lut文件,并将 LUT 与预设一起保存。 - 编辑窗复用编码滤镜生成静帧预览。Dolby Vision 保留源流模式需要切换普通转码后才能裁片、裁切或调色;INSV 原片的编辑预览需先导出为已拼接全景视频。对全景做裁切或画幅调整后,输出按普通平面视频处理。
- 识别带全景标签的源视频和 2:1 等距柱状候选;全景输出写入 Google Spherical Video V1 与标准 V2
st3d/sv3d元数据,并通过 ffprobe 回读验证。 - 支持导入 Insta360
.insv,自动配对旧机型的_00_/_10_双原片并合并为一个任务。预设的“全景”页可保存 FlowState 防抖、方向锁定、光流/动态/AI 拼接、镜头间色彩融合及降噪偏好。 - INSV 视频导出需要另行部署官方 Desktop Media SDK:先由 SDK 拼接为 2:1 全景中间视频,再按输出预设编码为所选格式;“跟随源文件”对 INSV 默认使用 MP4(ProRes 使用 MOV)。不输出可继续编辑的 INSV 原片。
- 可保存、编辑和删除“我的预设”;预设库与右侧当前任务的输出设置相互独立。
- 预设侧栏采用紧凑分组,可搜索名称、编码与参数并记忆折叠状态;任务设置和预设编辑器统一为“常用 / 色彩 / 输出”三个页签,支持码率数值输入和命名预览。
- 可选择全部输出到指定目录、原位输出或原位子文件夹,并支持原名或前后缀命名。
- 默认保留源视频的创建日期和修改时间;Windows 与 macOS 会分别写入并回读验证。
- 启动编码前检查输出目录可写性和剩余空间;重名文件使用可预测的数字后缀处理。
- 编码使用同目录临时文件,成功后才移动到最终路径;失败、取消时会清理临时文件。
- 设置按钮左侧可随时切换自适应并发(每次启动默认关闭)。开启后按逻辑 CPU 数和可用内存调度,最多同时运行 4 个任务;大尺寸帧和 INSV 拼接独占执行。关闭后等待当前任务结束,后续任务依次执行。
- 运行中的任务可以取消;任务详情、日志和错误状态保持可见。
- Windows 显示
CUDA、Auto和CPU,不显示 Metal。 - macOS 显示
Metal、Auto和CPU,不显示 CUDA。 - 其他平台显示
Auto和CPU。
- H.265 10bit(保留 HDR)
- H.264 高画质
- AV1 1080p 10bit
- ProRes 422 LT
- H.265 HLG 10bit
- H.265 HDR10 10bit
- Dolby Vision 保留导出
- Tauri v2 桌面壳
- React + TypeScript + Vite 前端
- Rust 后端命令负责平台检测、预设、ffprobe 元数据、FFmpeg 命令构建、编码进度和时间戳验证
- FFmpeg / ffprobe 从
PATH获取,或随打包应用一起内置
开始原生开发前,请安装 Rust stable、Node.js 或 pnpm,以及对应平台的 WebView2/Xcode 工具链。
pnpm install
pnpm tauri dev构建前端:
pnpm buildpnpm build:portableWindows 便携版会生成到 dist/VideoSizeComposer,直接运行其中的 VideoSizeComposer.exe。最终打包步骤会把 FFmpeg 和 ffprobe 放在应用旁边。
官方 SDK 需要通过 Insta360 开发者申请 审核后获得下载链接;公开 GitHub 仓库只有示例与文档。已安装的 Insta360 Studio 不等于安装了独立 Media SDK。
使用带 -model_root_dir 参数的新版官方 MediaSDKTest,将 Windows SDK 的完整 bin/ 内容(可执行程序、依赖 DLL、models/)放到便携程序旁的 insta360/ 目录,也可在“应用设置 → Insta360 全景处理”中选择 SDK 根目录或 bin/。支持通过 INSTA360_MEDIA_SDK_DIR 环境变量指定目录。开发时可将完整 bin 内容放入 vendor/insta360/,构建脚本会复制到便携包;SDK 不提交到仓库。
防抖、方向锁定、拼接与降噪仅对 INSV 原片生效,普通全景 MP4 不会重复拼接。AI 拼接和降噪需要 SDK 配套模型,部分功能还受拍摄机型及 SDK 版本限制。官方桌面 Media SDK 支持 Windows/Linux,当前 macOS 需先通过 Studio 导出全景 MP4。SDK 的运行环境及参数以 官方文档 为准。
拼接使用原全景尺寸和至少 80 Mbps 的 HEVC 中间视频,再进行最终编码,会增加一次有损编码与临时空间占用。预检查同时计算中间文件空间,拼接输出会核对尺寸、时长、位深、HDR 和音轨;失败或取消清理中间文件,不会将未拼接的鱼眼画面当成成功输出。自定义全景输出尺寸必须是 2:1,宽为 4 的倍数。MP4/MOV/M4V 写入并回读验证全景标记,其他封装的播放器识别需另行确认。
验证边界:自动测试以人工构造的多视频轨 MP4/INSV 验证配对、队列参数、转码、全景标记及 SDK 进程取消;不代表真实相机标定、FlowState 或 AI 拼接画质已经验收,仍需官方 SDK 与真实 INSV 样片验证。
macOS .app 包请在 macOS 上构建:
pnpm build:macpnpm build
cd src-tauri
cargo test
cd ..
powershell -ExecutionPolicy Bypass -File .\qa\hlg\verify-hlg.ps1Rust 测试覆盖编码器组合、HDR、LUT、全景元数据、导入、重名、临时文件、取消任务,以及创建/修改时间独立恢复等关键路径。
qa/hlg/verify-hlg.ps1 用随应用分发的 FFmpeg 复现 HLG 链路并逐项断言:HLG 标签落地、编码域峰值抽样分档、SDR 参考素材的 BT.2408 直映射亮度保持、满量程素材的软膝压缩、tonemap 各算法可用性、MDCV/MaxCLL 读取与未标注素材判定,全部通过时退出码为 0。测量结论见 qa/hlg/verification.md。


