-
-
Notifications
You must be signed in to change notification settings - Fork 21
Home
ReaPack is a package manager for REAPER, the Digital Audio Workstation.
It handles the installation and update of ReaScripts, JS effects and native REAPER extensions.
- Installation
- Setting up
- Finding packages
- Actions
- Filtering
- Updating
- Repositories
- About Dialog
- Import
- Advanced
The latest ReaPack binaries are available on this page. Download the corresponding file for your platform matching REAPER's architecture:
- OS X, REAPER 32-bit: reaper_reapack32.dylib
- OS X, REAPER 64-bit: reaper_reapack64.dylib
- Windows, REAPER 32-bit: reaper_reapack32.dll
- Windows, REAPER 64-bit: reaper_reapack64.dll
REAPER v4.7 or later is required. REAPER v5.12 or later is recommended for best experience (automatic Action List script registration is disabled in older REAPER versions).
Follow these steps to install ReaPack:
- From REAPER: Options > Show REAPER resource path in explorer/finder
- Put the downloaded file in the UserPlugins subdirectory (create it if it does not exists)
- Restart REAPER
Upon first launch you will be presented with the configuration dialog (also available from Extensions > ReaPack > Manage repositories). Start by enabling a few repositories to fill the package list:
Each repository give access to a different set of packages made by various users. More repositories can be inserted in the list using the import feature.
ReaPack allows you to select the specific packages you want or, if you prefer, install everything in bulk (see About Dialog). This section covers how to install a custom set of packages.
Open the Package Browser from the Extensions > ReaPack > Browse packages menu entry:
The first column at the left displays the package status:
Row 1 | Meaning | Row 2+ | Meaning |
---|---|---|---|
Empty | Package is uninstalled | Empty | No queued actions |
i | Package is installed | I | Queued for installation |
u | An update is available | R | Queued for uninstallation |
p | Package is pinned | P | Pin status modified |
o | Package is obsolete |
The version column shows both the currently installed version and the latest one in the repository between parenthesis. ReaScripts in the MIDI Editor category are installed in the corresponding section of REAPER's Action List. Other scripts are installed in the Main section.
Right click on a package or a selection of packages to get a menu of available actions:
Most of these are checkboxes that can be toggled:
- Install <version>, Update to <version>: Install the latest version of the package
- Reinstall <version>: Reinstall the currently installed version
- Versions menu: Install a specific version. It is also the recommended way to get pre-releases.
- Uninstall: Removes the package from your computer. Settings and other files created by the package itself are kept.
- Pin current version: Enabling this option will prevent this package from being automatically updated by the *Synchronize packages feature.
- Package Contents: Show a list of every files that are provided by this package.
- Package History: Show the changelog of every available version of this package.
- About <repository>: Open the repository's about dialog.
These actions are shown when more than one package are selected. They don't act as toggle and only have an effect if the action makes sense on a given package.
- Install/Update selection: No effect on up to date installed packages.
- Reinstall selection: No effect on uninstalled packages.
- Uninstall selection
- Clear queued actions: Cancel any unapplied changes to the selected packages.
Search in the list by typing words in the filter box. Put quotes around group of words to get exact matches (eg. "midi editor" note
).
Display tabs:
- All: Display every package matching the filter.
- Queued: Show the changes that will be applied when clicking on OK or Apply
- Installed: Any installed packages regardless of other states
- Out of date: If the repository has a newer version available for this package.
- Obsolete: These packages are not available anymore in their repository.
- Uninstalled: Packages you don't have yet.
The big button at the top right shows how many packages are currently displayed and how many are available in total. Click on it to get more options:
- Selecting the type of packages to show in the list (ReaPack will remember this setting the next time the browser is opened)
- Updating the package list (Refresh repositories)
- Quick access to the configuration dialog (Manage repositories)
Use Extensions > ReaPack > Synchronize Packages to update all installed packages (including ReaPack itself) to the latest available version. You can also update or downgrade specific packages from the Package Browser.
ReaPack's package list is fed by various customisable third-party repositories. Open the configuration dialog from Extensions > ReaPack > Manage repositories and right click on any repository or a selection of repositories to get the following menu:
- Enable/Disable: Disabled repositories are kept installed but won't be updated nor listed in the browser. Installed ReaScripts from disabled repositories are removed from the Action List until the repository is re-enabled.
- Refresh: Update the package list and metadata concerning this repository.
- Uninstall: Remove this repository entirely, including installed packages. See also Import.
- About <repository>: Opens the repository's about dialog.
Right click on a repository in the repository manager or any package in the package browser and select the About menu entry:
This window gives you access to documentation written by the repository maintainer, the list of packages in this repository and the list of files currently installed on your computer through ReaPack.
It also provides quick access to repository-related web pages and donation links. Use the Install/Update button at the bottom to install the full repository contents in bulk without having to select each package manually in the browser.
Use Extensions > ReaPack > Import a repository or the Import button in the repository manager to open the import window:
The URL to put in this dialog should have been given to you by the owner of the repository you whish to import. The golden rule of computer security applies to ReaPack repositories as well: don't install packages from untrusted sources.
The behavior of ReaPack can be tweaked with the following options (Extensions > ReaPack > Manage repositories):
- Install new packages automatically: With this setting enabled, Synchronize packages will install every package available in the repositories (instead of installing only updates).
- Enable pre-releases globally (bleeding edge): This mode will make ReaPack treat pre-releases as stable releases. This can be done on a per-package basis by explicitly installing a pre-releases from the Package Browser.