GitHub

MLT 官方 / 社区学习资源探查清单

纯网络调研（gh api + WebFetch/raw，未下载文件）。日期：2026-10-21。 用途：判断在已镜像的 mltframework.org/docs 之外，GitHub 上哪些资源对"学习 MLT"有参考价值。

一、官方仓库 mltframework/mlt（活跃度：极高）

最后推送 2026-10-20，最新 release v7.42.0（2026-10-03），约每 2-3 月一版；NEWS 逐版本记录 API 变更（含破坏性变更说明）→ 价值：高（changelog 最佳来源）。

  • README.md 只讲 CMake/devcontainer 构建，把"用法/开发细节"甩给官网 docs → 价值：中。
  • 仓库自带文档很少：docs/ 仅 melt.1（help2man 生成，melt 7.42.0 / 2026-10）→ 中（melt CLI 参数权威表）。
  • demo/ 是最被低估的宝藏：~30 个可运行 melt 脚本（mlt_jcut/mlt_lcut/mlt_voiceover/mlt_ticker/mlt_watermark…）+ demo/README 逐个讲解概念 → 高（学 melt/XML 组装最快路径）。
  • src/examples/play.cpp（28 行 mlt++ 最小播放器）、src/mlt++/（完整 C++ 封装 ~40 类）→ 高。
  • src/tests/：18 个套件（test_tractor/playlist/animation/xml/properties…）→ 高；注意官网 docs/unittests/ 仍写 qmake/tests.pro + 2013 输出，已过时（现为 CMake）。
  • src/swig/：绑定在树内（python/nodejs/perl/php/ruby/java/csharp/lua/tcl），python 模块名 mlt7，附 play.py/play_pyqt6.py/switcher.py/python_bindings.dox → 高。

二、官方文档站 + Doxygen（活跃度：高）

文档真源是 mltframework/mlt_web（2026-10-03 更新，2026-07 合并社区 PR "headless macOS 渲染指南"）。核心：developers/Framework.md（44KB，官方"必读路图"）、MltXml.md（19KB）、mlt++.md、plugins/ 服务手册（ConsumerAvformat 278KB、PluginsFilters 111KB）、melt CLI、authoringexamples/presets/profiles/propertyanimation/opengl/fxcut/headless。Doxygen 在线可用且与 7.42.0 同步 → 价值：高（首选）。

三、教程类

  • harryhaaren/mltutorial（社区）：低。仅 3 个 cpp，最后提交 2018-07-29，README 自称"6 年前、可能已失效"，转推 mltframework/BuildOnMe（2012 死库）。
  • 官网推荐外部视频教程 = Kris Occhipinti YouTube 播放列表：概念演示有用，非 API 级 → 中。

四、Python 侧

无独立官方 mlt-python-bindings 仓库（404），PyPI 也无 mlt/mlt7（须自编译或用发行版/Shotcut 包）→ 学习曲线最大坑。

  • gpapp/mlt-python（社区，pip 可装，2026-05-30）：纯 Python 读写 Kdenlive 兼容 MLT XML，带 MLT_XML.md + examples → 中高（学 XML 格式的捷径，不碰 C API）。

五、生产级参考实现

  • kde/kdenlive（官方镜像，2026-10-21）dev-docs/mlt-intro.md + fileformat.md（2026-05 维护）→ 高，producer/playlist/tractor/multitrack 概念与 XML 讲得最清楚。
  • mltframework/shotcut（同属 org，2026-10-20）src/mltcontroller.cpp、src/mltxmlchecker.cpp、filter-sets/*.xml（真实 MLT filter XML 片段）→ 高（真实工程用法与 XML 素材库）。
  • mltframework/mlt-scripts（官方跨平台构建脚本，2026-10-03）→ 中。

优先级建议

mlt_web 文档（Framework + MltXml）→ repo demo/ 脚本 → Kdenlive dev-docs → Shotcut filter-sets → Doxygen 查签名 → src/tests 验证语义；跳过 mlttutorial。

链接

Index