set_track_volume
Adjust audio track volume levels in REAPER DAW by specifying track number and volume value for precise mixing control.
Instructions
Set track volume.
Args:
track_number: Track number (1-based, as shown in REAPER)
volume: Volume level (0.0 = -inf dB, 1.0 = 0 dB)Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_number | Yes | ||
| volume | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- scythe_mcp/server/main.py:132-146 (handler)MCP tool handler for set_track_volume: registers the tool via @mcp.tool(), validates/clamps input, delegates to ReaperBridge.set_track_volume, returns success/error message.
@mcp.tool() def set_track_volume(ctx: Context, track_number: int, volume: float) -> str: """ Set track volume. Args: track_number: Track number (1-based, as shown in REAPER) volume: Volume level (0.0 = -inf dB, 1.0 = 0 dB) """ bridge = get_bridge() # Convert to 0-indexed internally if bridge.set_track_volume(track_number - 1, max(0.0, min(1.0, volume))): return f"Track {track_number} volume set to {volume}" return "Error: OSC command failed" - ReaperBridge helper method: sends OSC message to REAPER to set the volume of a specific track (1-indexed in OSC). Called by the MCP handler.
def set_track_volume(self, track_index: int, volume: float) -> bool: """Set track volume (0.0 to 1.0 normalized).""" # REAPER OSC: /track/N/volume return self.send_osc(f"/track/{track_index + 1}/volume", float(volume))