Sync tools for review systems

We provide a suite of tools to help with synchronization between different review systems. We provide reference versions for xStudio and OpenRV.

See:

  • OpenRV Sync Plugin (rvplugin/ori_sync): Enables OpenRV to join sync sessions, broadcasting and receiving playhead, display, and annotation changes. See the rvplugin README for details.
  • xStudio Sync Plugin (xstudio_plugin/ori_sync): Enables xStudio to join sync sessions. See the xStudio plugin README for installation and usage.

Full docs for the Annotation API are here.

Sync Tools

A suite of tools is provided to interact with, record, and test the sync protocol:

  • Sync Viewer (sync_viewer): A lightweight, web-based viewer that joins a sync session as a passive observer to display the live timeline state in the browser. See the sync_viewer README.
  • Sync Recorder (sync_recorder): A tool to record live sync session events into JSONL files and replay them later. Useful for debugging and creating test cases. See the sync_recorder README.
  • UI Sync Testing (sync_test): An automated end-to-end integration test framework that launches actual application binaries (xStudio, OpenRV) and uses recorded events to verify state synchronization. See the sync_test README.
  • Debugging & State Inspection (debug): Utilities for connecting to running review instances, configuring ports, and inspecting active viewport state. See the debug README.

Resources & Test Media

  • Test Media (test_media): Contains generated test charts and media sequences used for testing the sync plugins and test frameworks. See the test_media README.
  • Test Chart Generator (testchart): Scripts for generating the synthetic test media. See the testchart README.

Table of contents


This site uses Just the Docs, a documentation theme for Jekyll.