ola-rs

Rust client for Open Lighting Architecture RPC DMX control.

Compeller built this because REACT needs a small, reliable Rust path to OLA for DMX/ARTNet/sACN venue control. We are sharing it as a standalone utility for Rust, lighting, DJ, and show-control projects.

Current scope

Connect to olad over the OLA RPC TCP service, default 127.0.0.1:9010.
Send UpdateDmxData and receive Ack.
Send fire-and-forget StreamDmxData.
Read a universe with GetDmx.
Blackout helper for a universe.

Not included yet

Full OLA service API coverage.
RDM helpers.
Async/Tokio API.
Fixture patching convenience APIs.
REACT-specific code.

Quick start

ola-rs = "0.1"

use ola_rs::OlaClient;

fn main() -> ola_rs::Result<()> {
    let mut ola = OlaClient::connect_default()?;
    ola.update_dmx(0, &[255, 0, 0, 0], None)?;
    Ok(())
}

Examples:

cargo run --example blackout -- 0
cargo run --example chase -- 0

Safety note

This crate can change real lighting output. Test with a dummy universe or disconnected output before using it on a live rig. Keep a physical or console-level blackout available.

Protocol attribution

This crate is informed by the public Open Lighting Architecture RPC/protobuf protocol and by Deep Symmetry's ola-clojure project.

OLA: https://www.openlighting.org/ola/
ola-clojure: https://github.com/Deep-Symmetry/ola-clojure

This is a clean Rust implementation. It does not copy ola-clojure source code.

Contributing

Useful next contributions:

More OLA RPC methods.
Async/Tokio client.
Tests against a local olad fixture.
Universe discovery helpers.
RDM helpers.
Better examples for venue/show-control workflows.

License

MIT. See LICENSE.

ola-rs 0.1.0