Skip to content

Remote Control

Control Void Video from any device on your network using the built-in web interface, or use keyboard shortcuts directly.

Web Remote

The application runs an HTTP server on port 9100. Open a browser on any device on the same network and navigate to:

http://<device-ip>:9100/

This serves a built-in web dashboard that provides:

  • Real-time diagnostics -- GPU info, render stats, frame timing, histogram data
  • Configuration control -- Adjust HDR, video, warping, zoom, and display settings via REST API
  • Live captures -- View output, input, and mipmap metering frames
  • WebSocket updates -- Live streaming of metering and performance data

The separate admin UI (a Vue.js application) provides a full remote control interface for navigating settings. It connects to the same diagnostic server API on port 9100.

REST API Endpoints

EndpointMethodDescription
/GETWeb dashboard
/gpuGETGPU device info
/statsGETRender performance stats
/configGETFull configuration snapshot
/config/hdrGET/POSTHDR settings
/config/videoPOSTVideo/scaling settings
/config/warpingPOSTWarping settings
/config/zoomPOSTZoom settings
/config/displayPOSTDisplay settings
/meteringGETHDR metering data
/histogramGETHistogram results
/capture/outputGETScreenshot of rendered output
/capture/inputGETScreenshot of raw input
/xrayPOSTToggle X-ray heatmap

Keyboard Shortcuts

When sitting at the machine directly, all controls work via keyboard. Press M to open the on-screen menu, then use arrow keys to navigate.

See Keyboard Shortcuts for the full key binding reference.

IR Remotes

Void Video accepts standard keyboard input, so any IR remote configured to send keypresses will work out of the box. On Linux, LIRC can map IR remote buttons to keyboard events — simply map your remote's buttons to the Void Video keyboard shortcuts and you're set. No special configuration on the Void Video side is needed.

See Keyboard Shortcuts for the full key binding reference to map your remote buttons to.

HDMI-CEC

HDMI-CEC is not currently supported.