Skip to content
odio odio docs

HTPC

An HTPC running Kodi or a browser for streaming already handles video and media playback. odio fits right alongside it, you get a DAC-quality audio output for both movies and music, with unified control over every source.

Audio through the DAC

Section titled “Audio through the DAC”

Set PULSE_SERVER to the IP of your odio node, and all HTPC audio routes to the node’s DAC via PulseAudio TCP. This applies to everything running on the HTPC: Kodi, Firefox, Chrome, any application.

Kodi

Section titled “Kodi”

Run Kodi as a systemd user service with PulseAudio as audio backend:

[Unit]
Description=Kodi
After=graphical-session.target


[Service]
Type=simple
Environment=WAYLAND_DISPLAY=wayland-1
Environment=XDG_RUNTIME_DIR=/run/user/%U
Environment=PULSE_SERVER=192.168.x.x:4713
ExecStart=/usr/bin/kodi --standalone --audio-backend=pulseaudio
ExecStop=/usr/bin/killall kodi.bin
Restart=no
TimeoutStopSec=20


[Install]
WantedBy=default.target

Firefox / Chrome kiosk

Section titled “Firefox / Chrome kiosk”

For Firefox or Chrome kiosk (Netflix, YouTube, streaming services), use a templated systemd user service:

[Unit]
Description=%i
After=graphical-session.target


[Service]
Type=simple
Environment=WAYLAND_DISPLAY=wayland-1
Environment=XDG_RUNTIME_DIR=/run/user/%U
ExecStart=/usr/bin/firefox -P %i --no-remote --new-window --kiosk https://%i
ExecStop=/bin/kill $MAINPID
Restart=no
KillMode=mixed
TimeoutStopSec=5


[Install]
WantedBy=default.target

Enable with the service name matching the URL, e.g. systemctl --user start firefox-kiosk@netflix.com.

Plex

Section titled “Plex”

Plex users can stream directly to an odio node via AirPlay, no extra setup beyond Plex’s native AirPlay support. Confirmed by /u/Sterkenzz.

Unified control with go-odio-api

Section titled “Unified control with go-odio-api”

Install go-odio-api on the HTPC and it discovers every MPRIS player running in the session. Kodi requires the MPRIS D-Bus interface addon to be discovered.

With the systemd backend configured, you can start and stop Kodi, Firefox kiosk, or any other whitelisted service directly from the embedded web UI, the odio application, or Home Assistant.

Embedded UI on an HTPC node — PipeWire audio server, Kodi playing with cover art, and Bluetooth, Netflix, YouTube, tv.orange.fr, Kodi, PipeWire PulseAudio managed as services

Remote control

Section titled “Remote control”

Control the HTPC from anywhere: