Intro
通过一些编程,我们可以实现对 REAPER 很大程度上的自动化控制,进一步实现功能扩展、工作流定制等目标。
作者将分享在实践中总结的流程和方法,并提供一些工具库以降低使用和开发门槛。
安装
下载
从官网下载页下载对应系统的最新版本。
便携安装(portable install)
关于便携安装
不同于一般使用,自动化的应用通常需要使用便携安装(portable install)的方法来安装 REAPER。
各操作系统的便携安装流程
Windows:
- Windows 只支持使用安装程序安装
- 安装程序中勾选 Portable Install。
- 点击 “Browse…” 选择安装目录。
- 查看下面的「安装后配置」部分。
MacOS
- 在访达(Finder)中创建安装目录。
- 打开 dmg,将
REAPER64.app拖入目录中。 - 在目录中创建
reaper.ini文本文件。 - 查看下面的「安装后配置」部分。
Linux
- 将下载的压缩包解压缩至安装目录。
- 在安装目录中创建
reaper.ini文本文件。 - 如需要安装无图形界面模式,查看下面的「关于无图形界面模式」部分。
- 查看下面的「安装后配置」部分。
安装后配置
- 如未购买 & 激活许可证,REAPER 将以试用模式运行,每次启动时会弹出提示框。
- 如果需要实现自动化控制,则需要购买许可证书以避免弹出提示框:购买后将证书邮件中两行
—- cut —-之间内容保存到安装目录下reaper-license.rk。 - 启动一次 REAPER 以初始化配置文件,扫描系统中的插件。
关于无图形界面模式(Headless Mode)
目前只有 Linux 支持无图形界面模式,来源。
TODO instruction on headless mode
TODO and the Windows version works well with WINE.
运行
通过 CLI 运行 REAPER
各系统的可执行文件路径($path_to_install 为安装目录):
# MacOS$path_to_install/REAPER64.app/Contents/MacOS/REAPER# Windows$path_to_install/reaper.exe# Linux$path_to_install/reaper多开
对于一些复杂且繁重的任务,可以通过多开 REAPER 来提高效率。实现多开的方式有两种:
- 通过 CLI 运行 REAPER,可以通过
-newinst参数来启动新的 REAPER 实例。优点是不需要复制安装目录,缺点一些配置文件可能冲突。 这个方法在 REAPER-CLI 文档中有提及,但在 reaper -h 中没有。 - 复制多个便携安装目录,分别运行每个目录下的可执行文件。配置文件不会冲突,但是需要占用更多磁盘空间。
在 REAPER 中运行脚本的几种方式
- 通过 REAPER 的
Actions->Show action list...启动 Action 管理界面,可以查看、管理和运行脚本。 - 无论以何种方式启动 REAPER,
$resource_path/Scripts/__startup.lua中的内容都会被执行。可以在这个脚本中添加代码。 - 如果使用 6.80 以及更高版本,使用 CLI 运行 REAPER 时,可以通过传入 project/media 和一个脚本路径来运行 REAPER,加载 project/media,并执行脚本。
编写
关于语言
目前 REAPER 支持三种脚本语言:EEL2、Lua 和 Python。推荐使用 Lua,相比 EEL2 更通用易学,相比 Python 运行效率更高,对于某些任务高上百倍,REAPER 没有内嵌 Python 解释器也导致配置繁琐且不稳定。
Reascript 能实现什么
几乎所有你需要和不需要的功能。比如:
- 在一个按照混音轨道文件夹结构添加音轨
- 对拍导入歌曲
Reascript 开发常用工具
- 美化易用的 API 文档
- ReaPack:REAPER package 管理器,可以安装、更新、卸载社区贡献的海量脚本、JS 效果器、扩展、主题、语言包等等
Reascript Tips & Tricks
REAPER 功能补完
术语表
| 术语 | 中译 | 释义 |
|---|---|---|
$resource_path | 资源路径 | REAPER 的资源路径,可以在 REAPER 中通过 Options->Show REAPER resource path in explorer/finder 查看。 |
$path_to_install | 安装路径 | REAPER 的安装路径,如果是便携安装,这个路径会跟 $resource_path 相同。 |
| track | 轨道 | REAPER 中的音轨,更准确地说是轨道,因为 REAPER 中的只有一种 track,里面任何东西都可以随便放。 |