SuperAPI AI 工具集

m4l-py2max-tooling

编程与开发

查看项目

更新于 10-16 03:41

技能介绍

本技能用于以编程方式生成 Max for Live 设备,用代码构建 .maxpat/.amxd 文件,而非手工编辑 JSON。直接手写 .maxpat JSON 容易出错,numinlets、outlettype、project block、FOURCC、.amxd 头部字节序等错误会静默破坏设备,因此推荐使用已正确处理这些细节的 Python 库。

主要工具:shakfu/py2max 是首选,Python 3.9+,支持离线生成 .maxpat/.maxhelp/.rbnopat、往返读写编辑保存、SVG 预览、正确实现的 .amxd 二进制容器打包、CLI,以及含 1157 个对象、可校验进出口的 MaxRef 数据库。安装:pip install py2max,或从源码 git clone https://github.com/shakfu/py2max 后 pip install -e .。Barnard-PL-Labs/MaxPyLang 是更高层 DSL,面向用 LLM 编码代理生成和编辑 Max 补丁,安装:pip install MaxPyLang。Ableton/maxdevtools 为官方工具,含 maxdiff/amxd_textconv.py(.amxd 与可读文本互转)、m4l-production-guidelines、patch-code-standard、cpu-reporter,克隆:git clone https://github.com/Ableton/maxdevtools,转换命令:python3 maxdiff/amxd_textconv.py path/to/device.amxd。

使用方式:用 py2max 的 Patcher 构建对象与连线,例如 p.add_textbox、p.add_dial、p.add_line,再 p.save()。打包 .amxd 时用 from py2max.m4l import write_amxd, ensure_amxd_project_block,先 ensure_amxd_project_block(patcher_dict, device_type="audio_effect"),再 write_amxd("MyAmp.amxd", patcher_dict, device_type="audio_effect");设备类型有 audio_effect、instrument、midi_effect。往返编辑用 Patcher.from_file 或 read_amxd 读取后修改再保存。py2max 还提供 HorizontalLayoutManager、GridLayoutManager 布局工具,py2max serve myscript.py 浏览器实时预览,以及 MaxRef 校验对象进出口。

限制:py2max 的 MaxRef 数据库并非穷尽,第三方小众外部对象可能缺失,需手动设置进出口;对 live.banks/parameterbanks 结构支持尚不完整,涉及 Push bank 布局需检查输出 JSON;手工编辑加 Max 保存往返仍是修复格式边缘情况的可靠方式。MaxPyLang 较新、验证较少,API 以项目最新文档为准。