An independent product, not affiliated with or endorsed by Cockos Incorporated. REAPER is a trademark of Cockos Incorporated.
Something not working? Email contact
The keys talk to REAPER through REAPER's own web remote (in REAPER: Web browser interface), on this computer only (address 127.0.0.1).
The keys then say WEB REMOTE OFF. Two ways to add it:
reaper.ini.gramshift-backup. Then start REAPER. REAPER must be closed for this, because REAPER saves its settings when it quits.REAPER's settings file is %APPDATA%\REAPER\reaper.ini on Windows and ~/Library/Application Support/REAPER/reaper.ini on macOS. A portable REAPER keeps it in its own folder: enter the port of its web remote in the Port field of the key settings (REAPER: Options > Preferences > Control/OSC/web).
Put the Track Fader action on a dial. Turning it changes the volume (in steps of 0.1, 0.5 or 1 dB) or the pan of the track you choose, and the touch strip shows the track name, the value and its meter. Pushing the dial or tapping the strip mutes the track (or puts the pan back to the center).
| Key | Shows | Press |
|---|---|---|
| Transport | REAPER's play state (STOPPED, PLAYING, PAUSED, RECORDING) and the time. | Play / stop, play, stop, pause, play / pause, record, to the start or to the end. |
| Toggle | Whether the metronome, repeat or snap is on, and the ripple editing mode (OFF, PER TRACK, ALL TRACKS), also when you change it in REAPER. | Turns it on or off. Ripple: off, per track, all tracks, in turn. |
| Track | The track name, color and meter, and the state of the button you choose: MUTED, SOLO, ARMED, MON ON / MON OFF / MON AUTO, FX ON / FX BYPASSED / NO FX, SELECTED. | Mute, solo, record arm, monitoring, FX on / off or select, on the track you choose: a track number, selected (the first selected track) or master (mute and FX only). |
| Position | The play position in bars.beats or minutes:seconds. | Switches between the two. |
| Tempo | The tempo at the play position and the time signature. | Metronome on / off, tap tempo, or nothing. |
| Marker | The marker and region at the play position, and the next one. | To the next or previous marker, or to the marker number you enter. |
| Custom Action | The label you give it, and ON or OFF for actions that REAPER marks as on or off. | Runs the REAPER action you enter by its command ID: a number like 40364, or a name like _SWS_ABOUT for extensions and scripts. In REAPER: Actions > Show action list, right-click the action > Copy selected action command ID. |
Every key has the same connection settings: Port (empty = the web remote in REAPER's settings) and Login (empty, or user:password when the web remote asks for one).
| Message | What it means |
|---|---|
| NO REAPER · start REAPER | REAPER is not running. Start it: the keys connect by themselves. |
| WEB REMOTE OFF · see key settings | REAPER has no web remote yet. See No web remote in REAPER yet above. |
| REAPER NOT FOUND · set the port in key settings | REAPER's settings file was not found (for example a portable REAPER). Enter the port of its web remote in the key settings. |
| NO ANSWER · restart REAPER | REAPER's settings have a web remote, but nothing answers on its port. If it was just turned on, restart REAPER. If REAPER uses another port, enter it in the key settings. |
| REAPER BUSY · close the open window | A window is open in REAPER (a question, a dialog or the settings), and REAPER does not answer while it is open. Presses are not sent until it is closed; then the keys carry on by themselves. |
| LOGIN? | The web remote asks for a login. Enter it in the key settings as user:password, the one set in REAPER's web remote settings. |
| WRONG PORT · not REAPER | Another program answers on that port. Leave the port empty, or enter the port of REAPER's web remote. |
| PORT? · 1-65535 | The port in the key settings is not a port number. |
| NO TRACK 7 · project has 5 | The project has no track with that number. NO TRACK · select a track: the key follows the selected track and none is selected. |
| NO MARKER 3 · add it in REAPER | The project has no marker with that number. |
| COMMAND? / NOT FOUND | COMMAND?: what is entered is not a command ID. NOT FOUND: REAPER has no action with that ID (for example a script that was removed). |
| NOT CONNECTED, NO ANSWER, REAPER BUSY (on the bottom line, for a moment) | A press that did not reach REAPER, and why. |
No. No account, no analytics. The keys talk only to REAPER on this computer, through its web remote at 127.0.0.1.
It adds one web remote line to REAPER's settings file, the same line REAPER writes when you add a Web browser interface in its preferences, with a new random login so that only your keys use it, and keeps the old file as reaper.ini.gramshift-backup. To remove it, delete the web remote in REAPER: Options > Preferences > Control/OSC/web.
A track key follows the track number, as REAPER numbers the tracks. Enter the new number in the key settings, or use selected to follow the selected track.
Only actions that REAPER itself marks as on or off have a state. Other actions run on a press, and the key shows its label.
The project changes tempo, and the transport is stopped: the key shows the last tempo it read while playing. Press play and it shows the tempo at the play position again.
Stream Deck app 6.9 or later on Windows 10 or later, or macOS 12 or later. REAPER on the same computer.