DOVE — Online Video Editor

DOVE is an API driven Video/Audio Editor for live mixing with an intuitive web based Interface. Developed by and for DORFTV. Inspired by bbc/brave.

Concept

Inputs → Scenes → Program → Outputs

Inputs — media sources: local files, network streams, web pages, yt-dlp URLs, cameras, test patterns.

Scenes — compositor layouts combining multiple inputs. Each scene has slots with per-slot position, size, z-order, alpha, and volume controls.

Program — the currently live scene, sent to all active outputs simultaneously. Cut or crossfade between scenes.

Outputs — streaming destinations (SRT, RTMP, HLS, WebRTC, Decklink, etc.). Multiple outputs can share an encoder; dedicated encoders per output are also possible.

Features

Inputs

Input Pickers (Proxies) — Configurable dropdowns in the "Add Input" dialog for fast discovery of local files, webcams, NodeCG sources, MediaMTX/OvenMedia streams, SRT relays, and playlists. Define in config.toml with [proxy.<name>] sections. See dove/docs/proxies.md.

Outputs

Encoders

Hardware-accelerated encoding via VAAPI (AMD/Intel) or Vulkan Video. Software fallback via x264 / x265. Set video_encoder.name = "auto" to pick the best available encoder at startup. Multiple outputs can share a single encoder, or each output can have its own dedicated encoder. See dove/docs/encoders.md.

Audio & Video Filters

Per-input dynamic filter chains, applied at runtime without pipeline restart.

Audio: highpass, lowpass, 3-band/10-band EQ, compressor (LSP), expander (LSP), gate (LSP), limiter, amplify, pan, invert, echo, denoise, loudnorm. See dove/docs/audio-filters.md.

Video: color balance, flip/mirror, crop, color effects, blur, chroma key. Experimental (requires frei0r-plugins): pixelate, cartoon, glow, vignette, film grain, glitch, scanlines, sobel edge, color halftone. See dove/docs/video-filters.md.

Previews

• WebRTC — sub-second latency preview in the browser.
• HLS — works in restricted networks, through any reverse proxy over HTTPS.

Keyboard Shortcuts

Full keyboard control for live production: scene selection (1–9), cut/crossfade (Enter), transition toggle (T), and more. Press ? in the UI for the full list. See dove/docs/keyboard-shortcuts.md.

Quick Start

Want a ready-to-run setup with example inputs and scenes? See dove-demo for a pre-configured docker-compose stack you can spin up in one command.

To install DOVE from scratch:

Docker Compose

git clone https://github.com/dorftv/dove.git && cd dove
cp config-example.toml config.toml

Software rendering (no GPU):

docker compose up

AMD GPU (VAAPI + Vulkan):

docker compose -f docker-compose.yml -f docker-compose.amd.yml up

Intel GPU (VAAPI + Vulkan):

docker compose -f docker-compose.yml -f docker-compose.intel.yml up

Open http://localhost:5000

Configuration

Copy config-example.toml to config.toml and edit as needed. See dove/docs/config.md for all options.

[main]
default_resolution = "HD720"    # QHD, FullHD, HD720, nHD, …
default_framerate = "30/1"
volume = 0.7

[preview.scenes]
type = ["webrtcbin", "hlssink2"]
video_encoder.name = "auto"

Authentication

Optional OIDC authentication (Keycloak, Authentik, Authelia, etc.). Disabled by default — enable with:

[auth]
enabled = true
issuer = "https://auth.example.com/realms/dove"
client_id = "dove-app"
client_secret = "your-secret"

Four roles: User, Supervisor, Outputs, Admin. See dove/docs/auth.md for setup, role details, API tokens, and nginx integration.

Documentation

In-app help is available at /help after starting DOVE. All docs are in the dove/docs/ directory:

Setup — Interface overview · Configuration · Authentication

Pipeline — Inputs (uridecodebin3 · playlist · wpesrc · ytdlp · nodecg · testsrc · screencast) · Input Pickers · Scenes · Outputs · Encoders

Effects & Output — Audio filters · Video filters · Previews

Operations — Debugging · Connection Status

Tech Stack

• GStreamer 1.26+
• FastAPI + uvicorn — REST API and WebSocket
• Nuxt 4 — web frontend
• Python 3.12 or 3.13

Note: Python 3.14 is not supported for native installs due to PyGObject/GStreamer thread interaction bugs. Use Python 3.12 or 3.13. Docker images are pinned to 3.12 and unaffected.

Development

Running DOVE natively from a Python venv: see dove/docs/install.md.

Contributing

Contributions are welcome! Please open an issue first to discuss larger changes. For bug reports, include the GStreamer version, config, and relevant logs.

Notes

• Decklink requires a supported Blackmagic Design card and the decklink GStreamer plugin
• WebRTC previews use announced_ip for the server's public IP — set in config.toml or via ANNOUNCED_IP env var

License

GNU Affero General Public License v3.0