Skip to content

Home

Jump to bottom
github-actions[bot] edited this page Jul 5, 2026 · 6 revisions

OQL Wiki

OQL is a free, open-source show-control application for live theatre, concerts and events — inspired by QLab, built with C++20 and Qt6.

Documentation

For an illustrated introduction with screenshots and step-by-step guidance, see the online documentation.

Contents

Page Description
Download Pre-built packages and installation instructions (macOS/Windows first-launch warnings)
Beta Testing Beta builds — download, install, and report issues
Getting Started First launch, basic workflow, keyboard shortcuts
Cue Types Reference for every cue type and its parameters
Plugin Effects Built-in effects (EQ, Compressor, Reverb, Chorus…) and external VST2/LV2 plugins
Workspace Format .oqlab JSON file format reference
Building from Source Build instructions for Linux, macOS, Windows
Architecture Internal design for contributors

Quick start

git clone https://github.com/teonactl/oql.git
cd oql
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
./build/oql
# — or install with icon/launcher —
./install.sh

Feature overview

  • Audio cues — miniaudio-based stereo playback; per-cue volume, loops, fade in/out, trim, channel routing, volume automation curve
  • Video cues — fullscreen video output on a secondary window
  • Text cues — on-screen text display with full typography control
  • Microphone cues — live audio passthrough from any input device
  • Control cues — Stop, Pause, Play, Fade, Speed targeting any other cue
  • Effect cues — apply a plugin chain to an Audio cue for a fixed duration or permanently; auto-reset with ResetEffect cue
  • Built-in audio effects — 10 cross-platform effects (Gain, Delay, Reverb, EQ 3-band, Compressor, Limiter, Chorus, Tremolo, Phaser, Stereo Widener); no external dependencies required
  • VST2 and LV2 plugin support — per-cue effect chains with parameter editing and native GUI editors (Linux); custom search paths in Settings
  • Group cues — collapsible containers for organising large cue lists
  • Label cues — visual-only section markers
  • Timing chains — pre-wait, post-wait, auto-continue, auto-follow
  • Undo/redo — full snapshot-based undo stack

License

GPL-3.0 — see LICENSE.

Clone this wiki locally