Execute arbitrary Mu code in RV and return the result.

The code is evaluated via remote-eval. Use 'require commands;' at the start if you need commands functions like play(), stop(), etc.

Examples: execute_mu("{ require commands; string(frame()); }") execute_mu("{ require commands; play(); "playing"; }") execute_mu("{ require commands; sources(); }")

Load a media file (image sequence, movie, or single image) into RV.

Args: file_path: Path to the media file. For sequences use RV notation e.g. "/path/to/image.1-100#.exr" or just the path to one frame.

Load multiple media files into RV at once.

Args: file_paths: List of paths to media files.

Start playback in RV.

Stop playback in RV.

Toggle play/stop in RV. Returns the new state.

Get the current frame number in RV.

Go to a specific frame in RV.

Args: frame: The frame number to jump to.

Step forward by N frames.

Args: count: Number of frames to step forward (default 1).

Step backward by N frames.

Args: count: Number of frames to step backward (default 1).

Set the in-point (start of playback range).

Args: frame: Frame number for the in-point.

Set the out-point (end of playback range).

Args: frame: Frame number for the out-point.

Get the current in/out points as JSON.

Set the playback frames per second.

Args: fps: Target FPS value.

Get the current playback FPS.

Enable or disable realtime playback mode.

When enabled, RV will skip frames to maintain the target FPS.

Args: enabled: True to enable realtime, False to play every frame.

Set the playback loop mode.

Args: mode: One of "loop", "once", or "pingpong".

Get the full frame range and current state as JSON.

Returns JSON with: frame, frameStart, frameEnd, inPoint, outPoint, playing, fps.

Set the playback increment (direction and speed).

Args: direction: Positive for forward, negative for reverse. 1 = normal forward, -1 = normal reverse, 2 = 2x forward, etc.

List all sources currently loaded in RV as JSON.

Returns a JSON array with source node names.

Get detailed media info for a source node.

Args: source_node: The source node name (e.g. "sourceGroup000000").

Get source nodes visible at a specific frame.

Args: frame: Frame number to query (-1 for current frame).

Create a new empty session, clearing all current sources.

Clear all sources from the current session.

Save the current session to an .rv file.

Args: file_path: Path for the .rv session file.

Get current session information as JSON.

Returns: viewNode, frame, frameStart, frameEnd, sourceCount.

Switch RV's view mode.

Args: mode: One of "sequence" (play sources in order), "stack" (layer sources for comparison), "layout" (tile sources side by side).

Set the compositing mode when in stack view.

Automatically switches to stack view if not already in it.

Args: composite_type: One of "over", "add", "difference", "-difference", "replace", "topmost".

Toggle wipe mode on/off for A/B comparison in stack view.

Automatically switches to stack view first.

Get current view state as JSON.

Returns: viewNode, viewType, and wipe state.

Load a LUT file and activate it.

Args: lut_file_path: Path to the LUT file (.3dl, .csp, .cube, etc.). target: Where to apply: "look" (color pipeline), "linearize" (input linearization), "display" (display transform).

Deactivate the LUT on a target.

Args: target: Which LUT to clear: "look", "linearize", or "display".

Set CDL (Color Decision List) values.

All parameters are optional — only provided values are changed.

Args: slope: RGB slope values [r, g, b]. offset: RGB offset values [r, g, b]. power: RGB power values [r, g, b]. saturation: Global saturation value.

Deactivate CDL color correction.

Set exposure adjustment.

Args: value: Exposure value (0.0 = no change). channel: "all" for uniform, or "r", "g", "b" for per-channel.

Set gamma correction.

Args: value: Gamma value (1.0 = no change).

Set saturation.

Args: value: Saturation value (1.0 = normal, 0.0 = desaturated).

Get current color correction settings as JSON.

Requires at least one source loaded in the session.

Set display gamma.

Args: gamma: Display gamma value (e.g. 2.2 for sRGB-like).

Enable or disable sRGB display transform.

Args: enabled: True to enable sRGB, False to disable.

Set the viewport background.

Args: method: One of "black", "checker", "grey18", "grey50", "crosshatch".

Get OCIO config information as JSON.

Returns color spaces, displays, views, and looks from the active OCIO config (or a specific config file).

Args: config_path: Optional path to an OCIO config file. If omitted, uses the $OCIO environment variable.

Set the OCIO input color space for a source.

Inserts an OCIOFile node into the source's linearize pipeline, converting from the specified color space to scene-linear.

Args: colorspace: Input color space name (e.g. "sRGB - Texture", "ACEScg"). source_node: Source group name (e.g. "sourceGroup000000"). If omitted, uses the first source.

Set the OCIO display transform.

Inserts an OCIODisplay node into the display pipeline.

Args: display: Display name (e.g. "sRGB - Display"). view: View name (e.g. "ACES 1.0 - SDR Video").

Apply an OCIO look to a source.

Inserts an OCIOLook node into the source's look pipeline.

Args: look: Look name from the OCIO config. direction: "forward" or "inverse". source_node: Source group name. If omitted, uses the first source.

Get current OCIO state for all sources and display as JSON.

Returns which sources have OCIO nodes and their settings.

Remove OCIO nodes and restore default RV pipeline.

Args: target: What to clear — "linearize", "display", "look", or "all".