Tools

Tools

"deadcat-reaper provides 25 tools in six groups: transport, mix, navigation, session, media, and read."

Each tool maps to one action, and the arguments are validated before anything is sent to the DAW. Track numbers are one-based; volume and pan are normalized from 0.0 to 1.0, with 0.5 as center pan.

With REAPER's feedback device configured, write tools confirm their effect before answering: the server asks REAPER to re-send its state, waits for the feedback to settle, and reports the confirmed value, or says plainly that feedback has not confirmed it.

Transport

Four write tools control playback and recording.

Tool	What REAPER does
reaper_play	Starts playback.
reaper_stop	Stops playback or recording.
reaper_record	Starts recording on the armed tracks.
reaper_pause	Pauses at the current position.

Mix

Five write tools set levels, panning, mute, and solo.

Tool	What REAPER does
reaper_set_track_volume	Sets a track fader, 0.0 to 1.0.
reaper_set_track_pan	Pans a track: 0.0 left, 0.5 center, 1.0 right.
reaper_set_track_mute	Mutes or unmutes a track.
reaper_set_track_solo	Solos or unsolos a track.
reaper_set_master_volume	Sets the master output fader.

Navigation

Five write tools move the edit cursor and manage markers.

Tool	What REAPER does
reaper_insert_marker	Drops a marker at the edit cursor.
reaper_go_to_marker	Jumps to a marker by number.
reaper_next_marker	Jumps to the next marker.
reaper_previous_marker	Jumps to the previous marker.
reaper_go_to_time	Moves the edit cursor to a time in seconds.

Session

Seven write tools build and shape the session.

Tool	What REAPER does
reaper_insert_track	Adds a track at the end of the track list, confirmed by the track count.
reaper_set_track_name	Renames a track.
reaper_set_tempo	Sets the project tempo in BPM.
reaper_select_track	Selects a track, making it the target for inserted media.
reaper_new_project_tab	Opens a new empty project tab, leaving the current project untouched.
reaper_undo	Undoes the last edit.
reaper_redo	Redoes the last undone edit.

Media

One write tool places audio in the session. It uses a small ReaScript bridge, because REAPER's OSC surface has no media-item commands; the install page covers the one-time bridge setup.

Tool	What REAPER does
reaper_insert_media	Inserts an audio file on a track at a time position. Missing tracks are created, and the result reports the track's item count after the insert.

Read

Three read tools report the session state. They answer from REAPER's OSC feedback stream; before answering, the server asks REAPER to refresh its state, so the values are current.

Tool	What it reports
reaper_get_transport	Playing, paused, recording, position, and tempo.
reaper_get_track_state	One track's name, volume, pan, mute, and solo.
reaper_get_session_state	The transport, the master, and every reported track.