Skip to content
Christian Fillion edited this page Jun 10, 2016 · 146 revisions

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.

Summary

  1. Installation
  2. Setting up
  3. Finding packages
  4. Actions
  5. Filtering
  6. Updating
  7. Repositories
  8. About Dialog
  9. Import
  10. Advanced

Installation

Download the corresponding file for your platform matching REAPER's architecture from ReaPack's website.

Follow these steps to install ReaPack:

  1. From REAPER: Options > Show REAPER resource path in explorer/finder
  2. Put the downloaded file in the UserPlugins subdirectory (create it if it does not exists)
  3. Restart REAPER

Setting up

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:

Enabling repositories

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.

Finding packages

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:

Package Browser

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.

Actions

Right click on a package or a selection of packages to get a menu of available actions:

Package Actions Selection Actions

Per-package

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.
  • Pin current version: Enabling this option will prevent this package from being automatically updated by the *Synchronize packages feature.
  • Uninstall: Removes the package from your computer. Settings and other files created by the package itself are kept.
  • 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.

Selection-wide

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.

Filtering

Filtering Options

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)

Updating

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.

Update Changelog

Repositories

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:

Repository Actions

  • 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.
  • Copy URL: Put the index URL in the clipboard
  • Uninstall: Remove this repository entirely, including installed packages. See also Import.
  • About <repository>: Opens the repository's about dialog.

About Dialog

Right click on a repository in the repository manager or any package in the package browser and select the About menu entry:

About ReaTeam ReaScripts Repository

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.

Import

Use Extensions > ReaPack > Import a repository or the Import button in the repository manager to add a third-party repository to ReaPack:

Importing a repository

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.

Advanced

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 like stable releases. This can be done on a per-package basis by explicitly installing a pre-releases from the Package Browser.
  • Restore default settings: Reset options to the factory defaults and restore altered or removed default repositories.
Clone this wiki locally