SuperAPI AI 工具集

soundcraft

设计与创作

查看项目

更新于 10-31 16:05

技能介绍

SoundCraft 是一款 Pro Tools 风格的 DAW 与音频编辑器。soundcraft-cli 是其无头命令行驱动:无需打开窗口、无需音频设备,即可针对 .scraft 会话运行引擎命令。全部菜单项和混音器控件都位于同一命令注册表中(0.14.0 共 482 条),分为 session.、file.、track.、edit.、clip.、mix.、automation.* 等类别,运行中的应用也由同一注册表驱动。资料称已针对 macOS 上的 SoundCraft 0.14.0 与 soundcraft-cli 0.14.0 验证;软件尚处 1.0 之前,固定 id 或参数失败时可用 describe 查询。

用途与路线:构建会话(轨道、片段、淡化、增益、声像、插入、闪避)并导出,可用 scripts/sc_session.py spec.json;编辑已有 .scraft(加插件、淡化、自动化)并整体或按区间导出,用带 open 的 sc_session.py;对会话做一次性命令用 soundcraft-cli run;长命令列表用 soundcraft-cli script;单文件转换(采样率、位深、归一化、抖动)用 soundcraft-cli convert;文件夹转换用 scripts/sc_convert.sh;想在应用中观看过程则用 soundcraft-cli app。无头是默认方式,查看帮助无需启动应用。

脚本说明:sc_session.py SPEC.json [--dry-run] [--overwrite] 按 spec 新建或编辑会话,支持在指定时间放置文件、fade_in/fade_out 及 fade_shape、clip gain_db、volume_db、pan、带参数的插入、自动化点、duck(在另一轨片段下压低本轨)、原始命令,然后保存并可导出(路径、位深、格式、起止);时间可为秒或 m:ss.fff,脚本转为采样;输出 JSON 摘要及导出的采样率、格式、峰值和 LUFS;未经 --overwrite 不覆盖打开的会话、已有保存或已有导出。sc_inspect.py 可查看会话的轨道、插入及改动参数、发送、自动化、片段 id/时间/增益/淡化,或按关键词查注册 id 与参数签名,或查内置插件参数。sc_verify.py 输出 JSON,校验失败退出码 1,可校验音频(采样率、位深、时长、最大峰值、--level 窗口内峰值/RMS)和会话(轨道、插入、自动化、淡化),也可哈希目录并与清单比对。sc_convert.sh 批量转换 IN 中的 wav/aiff/flac 到 OUT,拒绝 OUT 等于 IN。

工作流程建议:先检查给定会话、输入音频信息及未用过的 id 或插件参数;保留原件,保存到新 .scraft 路径、转换到新文件夹;用绝对路径写命令;完成后用 sc_verify.py 读回会话与音频数据,并报告输出路径、已验证数字及未能完成的事项。

主要限制与陷阱:命令参数时间多为采样,而 CLI 的 --start/--end 是秒;--save 等于 --in 会被拒绝(除非 --in-place),convert 会覆盖输出;session.new 忽略 path,未 --save 不写文件;脚本遇首个错误即停且不保存;片段 id 在导入后才存在;mix.* 与 automation.* 需指定曲目;0.14.0 压缩器没有侧链输入,闪避需用音量自动化;存在音量自动化时 mix.volume 不再设定电平;立体声 mix.pan 不带 index 只动左旋钮;.scraft info 为文本且不显示混音器状态。