Reaper Toolbox is an automated build system that creates a unified, portable installer for the Reaper DAW.
It bundles the core application together with essential extensions such as SWS, ReaPack, and related documentation.
A PHP-based build system handles version detection, component downloads, and generation of Inno Setup installer scripts.
Weekly builds are automated via GitHub Actions and published directly to GitHub Releases.
Setting up Reaper with all essential extensions can be time-consuming. Reaper Toolbox automates this process, it downloads, configures, and packages everything into one ready-to-install bundle. This ensures a consistent, up-to-date environment with minimal effort.
The installer includes the following components:
- Reaper DAW: Core digital audio workstation (portable installation).
- Reaper User Guide: Official PDF documentation.
- SWS Extension: Comprehensive extension suite enhancing Reaper functionality.
- SWS User Guide: PDF documentation for SWS features.
- ReaPack: Package manager for extensions and scripts.
Reaper (Rapid Environment for Audio Production, Engineering, and Recording) is a powerful, lightweight, and highly customizable digital audio workstation. It supports multitrack audio and MIDI recording, editing, mixing, and mastering on Windows, macOS, and Linux. Reaper is known for its small footprint, fast performance, and extensive scripting and extension capabilities.
SWS Extension (Standing Water Studios) is a free, open-source add-on for Reaper that greatly expands its functionality. It provides hundreds of additional actions, tools, and workflow enhancements — including region management, auto-coloring, cycle actions, and project organization utilities. Many advanced Reaper workflows depend on SWS for extended automation and customization.
ReaPack is a package manager for Reaper extensions, scripts, and plug-ins. It allows users to easily browse, install, and update community-created Reaper tools from curated repositories. ReaPack makes it simple to manage and update extensions from one place.
-
Build Script (
build-tools/build.php): A PHP-based automation script that:- Defines version grabber classes for each component (Reaper, SWS Extension, ReaPack, user guides).
- Scrapes official websites and APIs to retrieve the latest version numbers and download URLs.
- Downloads all required files to the
downloads/directory. - Generates an auto-generated Inno Setup include file (
installer/install.iss) with installation commands for each component. - Outputs version information to
downloads/reaper_toolbox_versions.txtandrelease_notes.md.
-
Installer Scripts:
- Main Script (
installer/Reaper-Toolbox.iss): The primary Inno Setup configuration file that defines the installer metadata, UI, file associations, and includes the auto-generatedinstall.issfor component installation logic. - Auto-Generated Script (
installer/install.iss): Dynamically created by the build script, containing Pascal code for extracting and installing each component with progress updates.
- Main Script (
-
Bundled Tools:
- PHP Runtime (
build-tools/php/): Embedded PHP executable for running the build script on Windows. - Inno Setup Compiler (
build-tools/InnoSetup6/): Compiler for creating the Windows installer executable.
- PHP Runtime (
-
Version Detection: The PHP script queries official sources to get the latest versions of:
- Reaper DAW (from reaper.fm)
- Reaper User Guide PDF
- SWS Extension (from sws-extension.org)
- SWS User Guide PDF
- ReaPack Extension (from GitHub API)
-
Download Phase: Downloads all components to
downloads/(skipped if files already exist). -
Script Generation: Creates
installer/install.isswith installation steps for each component, including silent installs and file placements. -
Compilation: Inno Setup compiles the installer to
release/Reaper-Toolbox-v{version}-x64.exe. -
Testing: An automated installation test is done to verify the installer works correctly.
To build locally on Windows:
-
Run
build.bator execute:build-tools\php\php.exe build-tools\build.php build-tools\InnoSetup6\iscc.exe installer\Reaper-Toolbox.iss
-
Test with
test-installation.bat.
-
Appveyor -
Azure Pipelines(disabled) - Github Actions CI
-
Deployment: Weekly rolling Github Releases (Sunday)
-
- Grab Latest Versions
- Reaper
- https://www.reaper.fm/download.php
- Optional functionality provided by the Reaper installer:
- ReaMote network FX processing support
- ReWire
- ReaRoute ASIO driver
- Optional functionality provided by the Reaper installer:
- Reaper User Guide
- Reaper SWS
- Reaper SWS Guide
- ReaPack
- UltraSchall
- https://www.reaper.fm/download.php
- Reaper
- Download
- Build Installer
- Release