A PyQt6-based graphical controller and editor for OpenSCENARIO .xosc files. The application provides
a real-time simulation control interface with integrated XML editors for .xosc and .xodr files.
Two modes are available depending on your goal.
Download the latest release from the GitHub Releases page. Each release is built automatically by GitHub Actions and contains native installers for each platform.
Run OpenScenarioDrive-Windows-Setup.exe and follow the installer wizard.
Windows SmartScreen warning: Because the installer is not code-signed, Windows Defender SmartScreen may show a "Windows protected your PC" dialog. Click More info and then Run anyway to proceed with the installation.
Open OpenScenarioDrive-macOS.dmg, drag OpenScenarioDrive to Applications, then launch it.
The Linux release artifact is a ZIP that contains:
OpenScenarioDrive-Linux-x86_64.AppImage- self-contained executable
Extract the ZIP and keep both items in the same directory, then run:
chmod +x ./OpenScenarioDrive-Linux-x86_64.AppImage
./OpenScenarioDrive-Linux-x86_64.AppImagePlease see DEVELOPMENT.md
- Play / Pause / Restart / single-step - scenario control
- Rewind - scrub through recorded frame history without re-running the simulation
- Configurable time step - adjust the simulation
dtin the UI (0.001 s – 1.0 s) - Pause on event - automatically pause when a storyboard event or condition fires
- Live list of all active actors/objects in the scenario
- Select any actor to view and edit its 3D position (X, Y, Z) and orientation (heading, pitch, roll)
- Apply position changes to the running simulation
- XML syntax highlighting (tags, attributes, values)
- Line-number gutter with indent-based code folding (click ▾/▸ to toggle blocks)
- Auto-save - edits are flushed to a temporary file every 500 ms (no data loss on crash)
- Undo / Redo - full document history via undo stack
- Search - incremental find with forward/backward navigation and match highlighting
- Dynamic highlighting - when the simulation pauses on a storyboard event or condition trigger, the relevant XML element is automatically located, scrolled to, and highlighted
- Same XML editor features as the OpenScenario editor
- Road ID cross-highlighting: selecting an actor highlights the matching
<road>element
The Parameters panel lists every <ParameterDeclaration> exposed by the loaded scenario.
| Column | Description |
|---|---|
| Name | Parameter name as declared in the .xosc file |
| Value | Editable field - click any cell in this column to change the value |
To change a parameter click any cell in the Value column and type the new value and then click Apply and Restart - the simulator restarts with the new values applied.
| Panel | Description |
|---|---|
| Top-Down Viewport | 2D bird's-eye view of the road network and moving actors |
| World Properties | Current simulation time and active object count |
| Events | Colour-coded live log of storyboard state changes (blue) and condition triggers (green) |
The scenario and road network files (.xosc, .xodr) bundled with this application are sourced from the esmini project (Environment Simulator Minimalistic) and are used under their respective licenses. Many thanks to the esmini contributors for providing these open resources.
