Configuration

• codec -- HEVC provides better quality at the same bitrate. H.264 has wider compatibility.
• bitrate -- Leave at 0 for automatic bitrate selection based on resolution and quality preset. Set a value in kbps to override (e.g., 20000 for 20 Mbps).
• framerate -- Maximum capture framerate. The actual framerate may be lower depending on system performance.
• encoder -- "auto" selects the best available hardware encoder. Force "nvenc" for NVIDIA, "vaapi" for AMD/Intel, or "x264" for CPU-only encoding.

Runtime Escape Hatches

Most hosts should stay on automatic selection. Use environment overrides only to work around a specific field issue, then remove them after upgrading.

To set an override for the user service:

mkdir -p ~/.config/systemd/user/vdo-agent.service.d
cat > ~/.config/systemd/user/vdo-agent.service.d/override.conf <<'EOF'
[Service]
Environment=VDO_AUDIO_MODE=parec
# Environment=VDO_NVENC_MODE=copy
EOF
systemctl --user daemon-reload
systemctl --user restart vdo-agent

Only keep the lines you need. Delete the override file and restart the service to return to automatic selection.

Quality Presets

Viewers can select a quality preset from the session toolbar. These presets adjust encoding parameters on the fly:

Presets are selected by the viewer and do not require any agent configuration.

Applying Changes

After editing config.toml, restart the agent:

systemctl --user restart vdo-agent