ha-reaper
ha-reaper copied to clipboard
Reaper DAW custom integration for Home Assistant
REAPER DAW
REAPER is a complete digital audio production application for computers, offering a full multitrack audio and MIDI recording, editing, processing, mixing and mastering toolset.REAPER supports a vast range of hardware, digital formats and plugins, and can be comprehensively extended, scripted and modified.
Features
- monitoring current play state of REAPER instance
-
media_player
for transport actions (rewind, stop, play, pause, fast-forward) and volume - enabling/disabling metronome
- enabling/disabling repeat
- starting and stopping recording
- sensor for total number of tracks
- sensor for armed tracks
- a service for running REAPER actions, start recording, undo and redo
Sensors
-
switch.metronome
-
switch.repeat
-
switch.record
-
media_player.reaper
-
sensor.number_of_tracks
-
sensor.number_of_armed_tracks
-
sensor.time_signature
-
sensor.play_state
Manual installation
Place custom_components/reaper
directory inside custom_components dir and restart Home Assistant
HACS installation
This component is available on HACS default.
Configuration
Setup REAPER web interface
- Launch your REAPER DAW
- Hit
Ctrl + P
or go to Options > Preferences - Navigate to "Control/OSC/web" menu and click "Add"
- From the "Control surface mode" dropdown menu choose "Web browser interface"
- Set the web interface port or leave default
8080
- Optionally set username:password
- Optionally set the default web interface
- Copy the Access URL and paste it in your browser - now your REAPER has a web interface.
- Hit OK in both preference windows
Setup Integration
Before starting the setup please ensure that your REAPER instance is running and its web interface is accessible from the web browser.
To configure integration in Home Assistant, go to Configuration >> Integrations >> Add integration >> REAPER DAW or use My Home Assistant link:
After adding integration, you can configure hostname, port and optionally username and password of REAPER's web interface.
Configuration also allows you to specify an update interval in seconds, during which status data from REAPER will be fetched.