一个**零 Python 第三方依赖**的桌面视频转换器:界面用标准库 `tkinter`,转码交给 FFmpeg。
拖进去 → 选预设 → 点开始。没有 Electron、没有几 GB 的运行库,就一个几 KB 的 Python 包。
| | |
|---|---|
| **真的轻量** | 运行时依赖为 `0`。不装任何 pip 包就能开窗口,只有 FFmpeg 这个外部程序是必需的 |
| **开箱即用** | 自动探测 FFmpeg(PATH / winget / scoop / Homebrew / `imageio-ffmpeg` / 环境变量),找不到会给出逐平台的安装指引 |
| **批量队列** | 表格化管理多个文件,逐个转换、总进度、单文件进度、完整日志 |
| **拖拽添加** | 可选装 `tkinterdnd2`,把文件或整个文件夹拖进窗口即可;不装也能用按钮添加 |
| **按体积压缩** | 输入「压缩到 8 MB / 20 MB」,自动计算码率并走 **两遍编码**,比手动猜 CRF 准得多 |
| **安全** | 默认绝不覆盖已有文件,也不会把输出写回源文件;随时可中止当前任务 |
| **双形态** | 带 GUI,也带无界面 CLI(`vidflow clip.mkv --target-mb 8`),方便塞进脚本 |
| **跨平台** | Windows / macOS / Linux 同一套代码,CI 覆盖 3 系统 × 5 个 Python 版本 |
核心定位是:Python 层零依赖,只负责"拼命令 + 管进度 + 画界面",把不确定性全部推给外部 FFmpeg 子进程。
1、没有 ffprobe 时整个特色功能会塌
「按目标体积压缩」必须知道时长,但 imageio-ffmpeg 只带 ffmpeg 不带 ffprobe,而它恰恰是我给"懒得装 FFmpeg
的用户"准备的兜底方案。解法是 ffmpeg.py:134 的二级降级:先 ffprobe JSON,失败就跑 ffmpeg -i 从 stderr 里正则解析
Duration: 和分辨率。这样只装一个 ffmpeg 也能用两遍编码。
2、FFmpeg 自身的几个坑
- out_time_ms 名字是 ms,实际单位是微秒(历史遗留)。所以 progress_seconds() 优先解析无歧义的 out_time
字符串,微秒字段只作兜底并统一除 1e6。
- 两遍编码会留下 -0.log、-0.log.mbtree,文件名带后缀不可预测 → ffmpeg.py:402 用前缀 glob 清理。
- 第一遍输出必须写空设备,Windows 是 NUL、Unix 是 /dev/null,用 os.devnull 统一。
- 两遍模式必须去掉 -crf(CRF 和 -b:v
互斥),我没有写"通用参数剥离器"这种脆弱逻辑,而是给支持的预设从头构造命令(ffmpeg.py:209),避免误删 -preset
这类同名参数。
3、一个很容易漏的数据安全事故
同格式转码到原目录时,输出路径和源文件是同一个文件,哪怕用户勾了"覆盖"也会把源文件写坏。utils.py:81 的 output_path()
用 resolve() 做了显式比对并强制改名 —— 这是比"不覆盖已有文件"更隐蔽的一层。