Configuration & Display
Most settings have sensible defaults. You only need to change them for specific setups.
Config File
~/.config/vdo/config.toml
If the file doesn't exist, the agent uses defaults. Create it to override specific settings. Restart the agent after changes:
systemctl --user restart vdo-agent
Encoding
[encode]
codec = "hevc" # or "h264"
bitrate = 0 # 0 = automatic
framerate = 60
encoder = "auto" # "nvenc", "vaapi", or "x264"
The agent auto-detects the best encoder: NVIDIA NVENC first, then VA-API (AMD/Intel), then x264 software fallback. Override with the encoder setting if needed.
GPU setup
- NVIDIA: Install the proprietary driver. Verify with
nvidia-smi. NVENC is used automatically. Supports 4:4:4 chroma for sharp text. - AMD: Standard Mesa drivers work. VA-API encoding is automatic.
- Intel: Install
intel-media-driver. Verify withvainfo. - No GPU: H.264 CPU encoding works on any machine. Higher CPU usage but fully supported.
Check what the agent detects:
vdo-remote-agent --probe