Prev Previous Post   Next Post Next
Old 07-07-2018, 03:09 AM   #1
Human being with feelings
solger's Avatar
Join Date: Mar 2013
Posts: 4,044
Default ReaLauncher

Hello to all fellow Reaper users and welcome to the ReaLauncher discussion thread!

What's ReaLauncher?

ReaLauncher is a custom and Lua-based version of the standard Reaper startup prompt window with a number of additional features.
Powered by Lokasenna's GUI library v2 for Lua (see link in the Install instructions below). So also a big thanks to Lokasenna for his work!

Although I'm mainly testing things under Windows 10, macOS 10.10.5 (Yosemite) and Linux (64-bit), there's always room for improvement.
So if anyone encounters any bugs or errors, please let me know including some basic info like:
  • Operating system (Windows, macOS, Linux)
  • Reaper version (and if it's 32- or 64-bit)
  • A short description of the issue (what's the issue and when is it happening)

Feature requests (see post #2) are of course always welcome, as well.

Compact size

Expanded size with all tabs visible

Feature overview
  • Linux, macOS & Windows support
  • Separate tabs for Recent Projects, (.rpp) Project Templates, (.rtracktemplate) Track Templates, (.rpp) Projects, (.rpl) Project Lists and (.rpp-bak) Backups
  • Option to add additional custom folder paths for Project Templates and Track Templates (which are used in addition to the default template folders)
  • Option to set custom folder paths for Projects, Project Lists and Backups tabs
  • List-filter in each tab which supports input of multiple search words separated by a 'space' character
  • Global section with [New Tab], [New Project] and [Open Project] buttons
  • Selection of multiple entries via mouse (multi-select of listbox entries is already part of Lokasenna's GUI library)
  • File paths can be shown/hidden
  • 'Keep open' checkbox to switch the automatic closing behavior of the window
  • Scalable and resizeable window

Features that require SWS Extensions
  • [Recent Projects] tab for listing and managing the recent projects (with functions to remove selected entries and clearing the entire list)
  • [Show in Explorer/Finder] button to search for the location of a selected file
  • Setup of predefined Reaper Theme Slots and the possibility to switch between them (uses SWS Resources)

Features that require js_ReaScriptAPI
  • Function to preview attached 'demo' audio files (supported file extensions: .wav, .flac, .mp3 and .ogg)


Install instructions
  1. Install Lokasenna's GUI library v2 for Lua (via ReaPack)
  2. Afterwards, run the Script: Set Lokasenna_GUI v2 library path.lua Action from the Action List
  3. Install ReaLauncher (via ReaPack)
  4. Install SWS Extensions (see link below) - required for the Recent Projects tab functions, among others
  5. Install the js_ReaScriptAPI extension (via ReaPack) - required for the audio preview function
  6. Have fun!

Additional notes
  • Folder paths can be set in ReaLauncher's [Options] tab - accessible e.g. via the [F2] function key
  • Some general info and an overview of all key shortcuts can be found in ReaLauncher's [Help] tab - accessible e.g. via the [F1] function key
  • The window size is scalable via the function keys: [F10] toggles between a small & big window size, [F11] & [F12] lets you scale the window size down & up


Optional settings to always show ReaLauncher automatically at startup (requires SWS Extensions)
  1. Open the Action List and search for the Script: solger_ReaLauncher.lua entry
  2. Right-Click on the entry and then Copy selected action command ID
  3. Open Extensions > Startup actions > Set global startup action
  4. Paste the action ID (copied in step 2) into the input field and confirm via [OK]
  5. Open Options > Preferences > General
  6. Set Open project(s) on startup to [New project] (instead of the [Prompt] option which shows the standard Reaper startup prompt window)


Tips & Tricks (also visible in ReaLauncher's [Help] Tab)

Global Shortcuts for loading projects with FX Offline
  • Holding CTRL + SHIFT (Windows & Linux)
  • Holding CMD + SHIFT (macOS)
Another possibility is using the Open with FX offline option in the [Open Project] window

Selection of multiple list entries
  • SHIFT + LEFT CLICK: Selection of adjacent list entries
  • CTRL/CMD + LEFT CLICK: Selection of non-adjacent list entries
  • Loading a single list entry is also possible via DOUBLE CLICK

[Recent Projects] tab (requires SWS Extensions installed)

RIGHT CLICK on the Recent Projects listbox opens the (Remove entry | Clear list) context menu for removing selected entries or clearing the entire recent projects list.
The 'Remove entry' menu option is only available for the unfiltered list

Audio preview function (requires js_ReaScriptAPI)

Preparation: Place a WAV, FLAC, MP3 or OGG audio file with identical name into the same folder as the project or template file. Example: testproject.rpp / testproject.wav

Usage inside ReaLauncher:
  1. Adjust the preview volume knob (0 - 100 %) via LEFT DRAG or MOUSEWHEEL
  2. Select preview output channels (by default outputs 1/2 are used)
  3. Start & Stop a preview of a selected entry via DOUBLE CLICK on the volume knob or via the SPACE and * key.
Status colors:
  • SILVER: preview file available
  • GREEN: preview file playing


2020-02-02 - v2.1 -
2020-01-20 - v2.0 -
2019-11-30 - v1.7.4 -
2019-11-25 - v1.7.3 -
2019-11-20 - v1.7.2 -
2019-10-27 - v1.7.1 -
2019-10-20 - v1.7.0 -
2019-09-10 - v1.6.2 - Bugfix for handling nil values when saving the output channel the first time to Extstate (saving the first output by default)
2019-09-10 - v1.6.1 -
2019-08-31 - v1.6.0 -
2019-08-16 - v1.5.1 - Bugfix: New Project button was not working
2019-07-30 - v1.5.0 -
2019-01-30 - v1.0.1 - temporary removal of subversion filter due to further bugfixing & testing
2019-01-28 - v1.0.0 -
2018-08-18 - v0.1.6 -
2018-08-09 - v0.1.5 -
2018-07-23 - v0.1.4 -
2018-07-15 - v0.1.3 -
2018-07-11 - v0.1.2 - fixed issue with empty lists, filter is now automatically applied when typing
2018-07-08 - v0.1.1 - changed filter and sort function structure, last window position is now remembered
2018-07-07 - v0.1.0 - first version released for public beta testing

Last edited by solger; 02-02-2020 at 05:44 AM.
solger is offline   Reply With Quote

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

All times are GMT -7. The time now is 06:24 PM.

Powered by vBulletin® Version 3.8.11
Copyright ©2000 - 2020, vBulletin Solutions Inc.