一个 2012 年就开源的播放器,今天还在每天涨星
一个 2012 年就开源的播放器,今天还在每天涨星
在 GitHub 上,能活过十年的项目不少,但能在第十四年仍然保持每天都有提交、每天都有新 star 的,屈指可数。mpv 就是其中之一:它的仓库创建于 2012 年 10 月 13 日,如今 star 数停在 37.8k 附近,fork 3.6k,代码提交记录超过 5.5 万条。更有意思的是,它至今仍然是一个"命令行媒体播放器"——没有官网首页的华丽宣传片,没有"一键美化"的引导流程,甚至连一个完整的 changelog 都不提供,README.md 里直白地写着 "There is no complete changelog"。
一个把自己定位成 CLI 工具、把发布说明推给 git log 的项目,为什么没有被时代淘汰,反而持续吸引新用户?答案不在营销,而在它的结构:mpv 把自己做成了一个"播放能力的内核",而不是一个"播放器的界面"。本文结合仓库源码与近期社区讨论,拆解这条长达十四年的缓坡曲线背后的工程逻辑。
先把数字摆上桌:一条十四年的缓坡
先看可核实的事实。仓库页面当前显示的数据是:37.8k stars、3.6k forks、498 watching、1k 左右未关闭 issue、148 个待合并 PR,累计 55,901 次提交;仓库的 createdAt 是 2012-10-13,最近一次推送是 2026-11-05。本地工作副本的最新提交是 ci/mac: install libarchive and svt-av1 from source on macOS 27 runner,日期为 2026-11-04。
把这些数字摊平成日均值,会得到一个相当"反直觉"的结论:
| 指标 | 快照值 | 折算日均(约 5137 天) |
|---|---|---|
| Stars | 37,750 | 约 7.3 |
| Forks | 3,627 | 约 0.7 |
| Commits | 55,901 | 约 10.9 |
也就是说,mpv 平均每天要落 11 个提交、涨 7 个 star,连续十四年。这不是爆发式曲线,而是一条几乎水平的、被长期维护拉直的斜线。爆发型项目的典型形态是"三月冲顶、随后长尾归零"——热度由发布事件驱动,事件过去,曲线就贴到零轴。mpv 的形态相反:它的每一次 star 增长都不是由某个版本发布会带来的,而是由"某个用户今天第一次遇到一个打不开的文件"带来的。这类需求是长期存在、持续发生的。
值得注意的是版本节奏。按 DOCS/release-policy.md 的规定,正式版本"一年一到两次",从 master 上切出来打 tag 后就不再单独维护;发布的目的被写得很清楚——"provide Linux distributions with something to package",而想要新功能的人直接用 master,且项目会尽力保证 master 随时可部署。0.41.0 就是在这种节奏下于 2025 年底发布的,距上一版约九个月。这意味着 star 增长的主要入口不是 release,而是滚动更新的发行版包管理和第三方构建:
meson setup build
meson compile -C build
meson install -C build
上面三条命令来自 README.md,也是这个项目对"如何获得它"的全部官方回答。
命令行不是妥协,而是可编程性的起点
很多人对 mpv 的第一印象是"一个黑框",但 README.md 的措辞其实很精确:a media player for the command line。它不是"没有 GUI 的播放器",而是"把控制面抽象成命令的播放器"。
这一点在 DOCS/tech-overview.txt 里有清晰的架构描述:player/*.c 构成"前端",负责 main()、播放循环、子系统初始化与数据推动;核心状态集中在 MPContext(player/core.h),并且明确写着"other subsystems rarely call back into the frontend, and the frontend polls them instead"。这是一个典型的、以轮询与状态为中心的前端-后端分层:解码、解复用、音频输出、视频输出都是可替换的后端,前端只负责把数据在它们之间推进。
这层设计的直接产物,就是 mpv 所谓的 command interface。按 DOCS/interface-changes.rst 的定义,它由五样东西组成:options、commands、properties、events、hooks。这五样东西同时服务于三类使用者——终端用户、Lua 脚本、libmpv 与 JSON IPC。换句话说,用户敲的 --hwdec=auto、脚本里读的 time-pos、外部程序通过 socket 发的 loadfile,走的是同一套接口。这就是为什么 mpv 可以既是一个播放器,又是一个库。
JSON IPC 的存在把这一点推到极致。DOCS/man/ipc.rst 给出的最小示例足够说明问题:
mpv file.mkv --input-ipc-server=/tmp/mpvsocket
echo '{ "command": ["get_property", "playback-time"] }' | socat - /tmp/mpvsocket
# {"data":190.482000,"error":"success"}
协议实现位于 input/ipc.c,命令与事件在内部被转换成 mpv_node 树再由 misc/json.c 序列化。文档同时也毫不客气地警告:这不是安全协议,无认证、无加密,run 命令可直接执行系统命令,用途仅限本地控制。这种"把能力和边界一起写清楚"的态度,恰恰是它能被大量第三方程序当作后端的原因——集成者知道自己拿到的是什么。
在 C 层面,这套东西就是 libmpv。include/mpv/client.h 开篇即声明 API 的两种用法:内部为 Lua 脚本提供能力,外部通过 mpv_create() 把 mpv 嵌进别的应用。当前 MPV_CLIENT_API_VERSION 为 MPV_MAKE_VERSION(2, 6)。一个最小嵌入流程大致是这样:
mpv_handle *ctx = mpv_create();
mpv_set_option_string(ctx, "hwdec", "auto");
mpv_initialize(ctx);
const char *cmd[] = {"loadfile", "video.mkv", NULL};
mpv_command(ctx, cmd);
mpv_observe_property(ctx, 0, "time-pos", MPV_FORMAT_DOUBLE);
十行不到,就得到了一个"能播、能硬解、能持续上报进度"的播放内核。对做播放器的团队来说,这十行的价值远高于任何 UI 主题。
复利从哪里来:解码、渲染、脚本三层
mpv 的长期增长,本质上是三层依赖的复利叠加。
第一层是解码。 meson.build 顶部把 FFmpeg 的各个库版本要求写死为最低门槛:libavcodec >= 60.31.102、libavformat >= 60.16.100、libavfilter >= 9.12.100 等。这意味着 mpv 不需要自己追每一个新编码格式——FFmpeg 支持了 AV1、支持了新的封装,mpv 只需要跟进接口。0.41.0 的发布说明里,"requires FFmpeg 6.1 or newer" 被单独列出来,就是这个契约的显式化。
第二层是渲染。 仓库当前 meson.build 要求 libplacebo >= 7.387.0,而 0.41.0 发布时要求的是 libplacebo 6.338.2 or newer——这个差异本身说明 master 已经在向 0.42 演进。渲染层的切换是 0.41 最重要的架构事件:基于 libplacebo 的 gpu-next 正式取代服役多年的 gpu 成为默认视频输出。在 video/out/vo.c 的驱动表里可以看到它的优先级被写在最前:
static const struct vo_driver *const video_out_drivers[] =
{
// high-quality and well-supported VOs first:
&video_out_gpu_next,
&video_out_gpu,
...
而 video/out/vo_gpu_next.c 把渲染工作交给 libplacebo 的 pl_render_image() / pl_render_image_mix() 与 pl_queue,mpv 自己则专注在帧队列、时序与参数映射上。同期 vd_lavc 也把 Vulkan 硬解排到了其他后端之前。渲染后端一旦被抽成"给 libplacebo 喂帧"的薄层,HDR 色调映射、ICC 色彩管理、字幕峰值亮度这些能力就变成了上游的增量,mpv 只需接收。
第三层是脚本。 这是最容易被低估的一层。player/lua/ 目录下,player/lua/osc.lua 有 3508 行,player/lua/console.lua 2173 行,player/lua/stats.lua 1825 行,player/lua/select.lua 1451 行,player/lua/ytdl_hook.lua 1254 行。这些脚本不是插件,而是编译期被塞进二进制的内置功能——player/lua/meson.build 用 TOOLS/file2string.py 把每个 .lua 转成 C 字符串再 #include 进 player/lua.c。所以用户下载一个 mpv 二进制,就已经拥有了 OSD 控制器、控制台、统计面板、右键菜单和 yt-dlp 集成。
0.41 新增了 player/lua/context_menu.lua(696 行,右键上下文菜单),0.42 开发线上又在持续加 select.lua 的 edit-config-file 之类能力。脚本层用 Lua 写,但后端是可替换的:meson.options 里 lua 是一个 combo 选项,可在 luajit / lua5.1 / lua5.2 之间选择,同时还保留 javascript(MuJS 后端)这一路。对贡献者来说,加一个界面功能的门槛是"写一个 lua 文件 + 加一行到 lua_files 列表",而不是"理解整个渲染管线"。
稳定接口:把生态的迁移成本压到最低
一个十四年的项目最大的敌人不是技术债,而是接口漂移导致生态流失。mpv 在这件事上有非常明确的书面契约,DOCS/compatibility.rst 把命令行与 API 的变更分级:
- 新增基本永远允许,使用者应当预期新函数、新选项会出现;
- 关键接口(如
seek)如果必须破坏,需要至少 1 年的弃用期,且弃用期间功能仍然可用; - 重要且高频使用的部分,必须先弃用至少 2 个正式版本,并且至少有 1 个版本里"旧功能可用 + 新替代方案已存在"。
include/mpv/client.h 的版本号规则与之呼应:不兼容的 C API 变更抬主版本,纯新增抬次版本。翻看 DOCS/client-api-changes.rst 能看到这种节奏:0.35 移除早已废弃的 opengl_cb API、mpv_suspend/mpv_resume;0.36 加 mpv_del_property;0.37 加 mpv_time_ns;0.40 弃用 MPV_RENDER_PARAM_AMBIENT_LIGHT;而 0.42 线上则新增了 MPV_RENDER_API_TYPE_D3D11 与配套的 include/mpv/render_d3d11.h。
变更记录机制本身也做了工程化约束:DOCS/interface-changes.rst 顶部明确写着"Never write to this file directly except when making releases",日常改动要写进 DOCS/interface-changes/ 目录下的独立片段文件,发版时用 TOOLS/gen-interface-changes.py 汇总。当前该目录里躺着 80 个片段文件,每条只是两三行,例如:
- vo: add options to control background tile appearance (transparency)
- sub: add control for libass caching options (glyph-limit, bitmap-max-size)
这种"一事一文件、发版时合并"的做法,让 PR 作者不需要在多人并发修改的巨型 changelog 里抢行号,也让 review 可以聚焦在"这个变更是否构成不兼容"上。DOCS/contribute.md 甚至规定了"每个不兼容变更必须在 DOCS/interface-changes 里留一条小记"。
对生态而言,这套契约的直接价值是:一个 2019 年写的 Lua 脚本、一个 2021 年写的 libmpv 集成,在 2026 年的版本上大概率还能跑。迁移成本越低,二次开发的沉淀越多;沉淀越多,新用户遇到问题时能搜到的答案越多。 这是 mpv 涨星曲线最隐蔽的推力。
社区在用 mpv 做什么:它早已不是"一个播放器"
从近期的中文社区内容可以清楚看到 mpv 的角色迁移。
最常见的仍是"开箱配置"类需求:有文章把上手路径压缩成"5 分钟装好,3 行配置",核心就是硬解、网络缓存、中文字幕优先级三条;也有文章直接对比 mpv 与 VLC,指出 mpv 更专注播放、VLC 更像媒体中心。这类内容稳定产出,说明基础盘仍在扩大——每一年都有新用户第一次面对"某些格式播不了"的问题。
第二类是"把它当组件"。Qt 集成、libmpv 内嵌的教程持续有人写,典型流程就是在工程里引入头文件与库,然后通过 mpv_set_property / mpv_command 控制播放。这与 include/mpv/client.h 的定位完全一致:API 不给你访问单个组件的权限,只给你"整个播放器"的控制权。
第三类是"把它当画质实验平台"。围绕 Intel UHD 核显跑 4K/8K 的 VAAPI 配置、围绕 HDR 转 SDR 的参数调优、围绕浏览器联动投送 URL 与播放中动态切换着色器,这些内容的技术深度已经远超"播放器使用教程"。它们的共同前提是:mpv 的渲染路径可以按参数重写,且改完不需要重编译。
第四类是"发行形态的分叉"。Windows 侧的 mpv-lazy 懒人包把 200+ 着色器、模块化中文配置、硬解优化打包成开箱即用的方案;macOS 侧的 IINA 则直接建立在 mpv 播放库之上。这两者的存在恰好说明同一件事:mpv 的内核足够稳定,稳定到别人可以在它上面做"上层产品",而不用担心内核明天换掉自己。
0.41 的变更也在强化这个方向:Wayland 下新增 wp-color-representation-v1 支持与 color-management-v1 v2 适配、平板输入、剪贴板写入;X11 补上剪贴板后端;Linux 通过 sysfs 的 ALS 接口读取环境光;Android 引入不依赖 JNI 的原生 AAudio 后端;Windows 增加了把 mpv 注册为系统媒体应用的辅助工具。这些不是"播放器该有的功能",而是"一个播放后端在各种宿主环境里该补齐的能力"。
被低估的部分:一个"不做产品"的项目
如果把 mpv 和那些同期爆发的项目放在同一条时间轴上,最大的差别不在技术选型,而在目标函数的定义。
爆发型项目通常追求"用户第一次打开就惊艳":自带 UI、自带引导、自带生态商店。这类项目的 star 曲线陡峭,但也高度依赖持续的产品投入——一旦界面不再更新,增长立刻停止。
mpv 把目标函数写在了文档里。README.md 的 System requirements 段落甚至带着一点挑衅:"mpv does not go out of its way to break on older hardware or old, unsupported operating systems, but development is not done with them in mind. If things work, consider it a happy accident."(如果它在旧环境上能跑,请当作一个愉快的意外。)它明确表示不追求在低功耗核显上省电,硬解默认都不开,还建议这类设备用 --profile=fast——这个 profile 就定义在 etc/builtin.conf 里:
[fast]
scale=bilinear
dscale=bilinear
dither=no
correct-downscaling=no
...
它不打算讨好所有人,只打算把"播放"这件事的每一层都做成可替换、可观测、可脚本化的部件。于是它的增长不来自发布事件,而来自需求本身:今天有人要播一个 10-bit HDR 的 HEVC,明天有人要把播放能力嵌进自己的 Qt 应用,后天有人要在无头服务器上用 IPC 远程控制播放进度。每一个这样的需求都会带来一次 star,而它们分散在十四年的每一天里。
这就是那条曲线的真相:日均 7 个 star、日均 11 次提交,不是因为项目在"运营",而是因为它在十四年里始终维持着同一种承诺——内核稳定、接口有契约、能力可组合。对一个播放器来说,这算不上浪漫;但对一个被 3.6k 个 fork 反复引用的基础设施来说,这恰恰是最高级的活法。