Skip to content
gatOS

Edit a Cinematic Take with photog

The direct camera guide teaches the controls. photog-rs is what you reach for when a shot has more than one idea in it.

It is a ratatui editor for ordered shots. You choose anchors, frames, positions, aim targets, timing, and lens settings, then compile them into a native camera track plus an optional timed-command sidecar.

Run it

Section titled “Run it”
inside the gatOS guest
cd /mnt/gatOS/examples/photog-rs
cargo run --release

Or run it on the host against HTTP:

host-side
cargo run --release -- --url http://127.0.0.1:4242/v1
  1. Create a project and add a shot.
  2. Choose a vessel or body anchor from live discovery.
  3. Set the placement frame and camera offset.
  4. Aim at a vessel, body, part, or fixed point.
  5. Preview the shot, then compile it.
  6. Play the generated track and sidecar together.

The project file is versioned JSON. The compiler samples ordinary camera leaf writes onto the shared timeline, so the finished take remains inspectable instead of becoming mysterious editor goo.

Camera referenceOwnership, frames, targets, leaf grammar, track schema, timing, and limitations.