用途:处理 Ableton Live 中 Max for Live 设备的 .amxd 容器格式,实现 .maxpat(Max 补丁 JSON)与 .amxd 之间的转换、打包与提取。.amxd 并非简单改名的 .maxpat,而是 IFF 风格二进制容器,含 36 字节混合端序头部、NUL 结尾的补丁 JSON,以及 dlst/dire 依赖尾块。
主要能力:
- 解析字节布局:偏移 0 为魔术字 ampf,偏移 4 与 16 为小端,偏移 24/28/32 及所有尾块尺寸为大端。
- 设备类型 FOURCC:aaaa 音频效果、iiii 乐器、mmmm MIDI 效果、nagg/natt(Live 12 MIDI 工具)、ciph 加密设备。头部 FOURCC 必须与 JSON 内 project.amxdtype 一致。
- 提取:读取头部与 mx@c 前导,取 NUL 前 JSON。注意直接改扩展名无效。
用法:
- 打包:python3 scripts/pack_amxd.py audio_effect input.maxpat output.amxd
- py2max 方式:from py2max.m4l import write_amxd, ensure_amxd_project_block;先 ensure_amxd_project_block(patcher_dict, device_type="audio_effect"),再 write_amxd("MyDevice.amxd", patcher_dict, device_type="audio_effect")
- 冻结含多依赖设备提取:python3 maxdiff/amxd_textconv.py path/to/device.amxd(来自 Ableton/maxdevtools)
适用场景:将 Max 补丁打包为 Live 设备、从已有设备提取 .maxpat、分发前冻结设备以嵌入依赖。
限制:格式未由 Cycling '74 公开文档化,内容基于逆向工程;三种块形式可加载但非往返稳定;架构需覆盖 arm64/x86_64/mxe64;拖放到轨道加载,双击无效;.amxd 改动需重新拖入。用户库路径与具体版本措辞未在此展开。