Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nikarh/reaper-remote-bandui
Web UI for Reaper remote interface used to simplify channel mixing for live shows
https://github.com/nikarh/reaper-remote-bandui
concerts mixing music reaper reaper-ui rehersal remote-control ui web
Last synced: 3 months ago
JSON representation
Web UI for Reaper remote interface used to simplify channel mixing for live shows
- Host: GitHub
- URL: https://github.com/nikarh/reaper-remote-bandui
- Owner: nikarh
- License: mit
- Created: 2023-03-17T13:26:41.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-25T12:46:31.000Z (5 months ago)
- Last Synced: 2024-10-25T04:25:21.658Z (4 months ago)
- Topics: concerts, mixing, music, reaper, reaper-ui, rehersal, remote-control, ui, web
- Language: TypeScript
- Homepage:
- Size: 2.88 MB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# reaper-remote-bandui
[](https://github.com/nikarh/reaper-remote-bandui)
[](https://github.com/nikarh/reaper-remote-bandui/actions/workflows/release.yaml)
[](https://github.com/nikarh/reaper-remote-bandui/releases)
[](https://github.com/nikarh/reaper-remote-bandui/releases.atom)
[](https://github.com/nikarh/reaper-remote-bandui/commits/main.atom)
My musical band uses an IEM setup for rehearsals and live shows.
This setup is based on a [USB audio interface](https://www.behringer.com/product.html?modelCode=P0B2J) and software mixing in [REAPER](https://www.reaper.fm/).
In REAPER we use named regions for songs and simple sends from input channels to personal channels with a hardware output for each band member.
To simplify mixing we use a web control feature of REAPER and each band member does mixing of their output from a phone. Fortunately, REAPER already includes an interface that allows doing just that - `more_me.html`. Unfortunately, though, this interface doesn't allow switching tracks or starting or stopping playback.
This project aims to fix that by providing a mobile-first web UI that provides a way to:
- Control playback
- Switch between songs (regions) and their parts (markers)
- Do an individual mix for each band member
## Repository contents
This repository contains
- Source code for REAPER remote control web UI
| Control | Mix |
| --- | --- |
|  |  |
- `Mother Project.RPP` - A sample reaper project that can be used with this UI
## Remote UI
### Building
Clone the project, install the dependencies, and build it with an npm command.
```
git clone https://github.com/nikarh/reaper-remote-bandui.git
npm i
npm run build
```
The built HTML file will be in `./dist/index.html`.
### Development
This project does not have a mock backend, so you actually need to run REAPER with the provided `Mother Project`, if you want to see anything sensible.
By default proxy server expects REAPER to be running on port `8080`.
## REAPER project layout
For this UI to work, your REAPER project must follow some rules.
1. All songs are marked as regions from the beginning to the end. The region must have a name (song name). Regions should not overlap.
2. Tracks for which mixing is possible must have both
- A hardware output
- At least one send
The mixing process is implemented by changing the gain of individual sends.
The example project has more tracks than just inputs and outputs so here is a brief explanation of their purpose.
- A MIDI track is used for song markers (like chorus and verse). In my experience using REAPER markers for that would cause too much of a mess (though markers are also supported by this UI).
- Click track is used for `Click source` items or simply put metronome. The global metronome usually doesn't cut it, because each band member usually prefers a different loudness for it (e.g. it's very important for a drummer but not so much for a vocalist).
- The `Audio` group is for tracks where you would put pre-recorded WAV files, like backtracks and vocal backtracks.
- The `Inputs` group is for tracks having a physical input source, like a guitar or a microphone. If any additional processing is needed (compression, eq, reverb), it should be put on these tracks.
- The `Outputs` group is for tracks with physical outputs. All of these tracks have plugins for basic hearing safety - a `-10 dB` gain and a brick-wall limiter at `0 dB`. These tracks have "Receives" from input group tracks and audio group tracks.
## Notes
When a specific song (region) is selected from the UI, it selects the region and sets the cursor to the beginning of the region. Selecting the region allows stopping the playback automatically when the region ends. For REAPER to stop the playback automatically you need to check `Preferences` -> `Audio` -> `Playback` -> `[x] Stop playback at end of loop if repeat is disabled.` and disable repeat in your project.