Skip to content

How to integrate odio with Home Assistant

odio-ha is a native Home Assistant integration, available in the Home Assistant Marketplace. Each odio node appears as a single HA device with its stack exposed as entities.

A node can be a full odio streamer on a Raspberry Pi, or just go-odio-api running on any Linux machine with a D-Bus user session (desktop, NAS, laptop). Same integration either way, HA exposes whichever capabilities the node actually has.

Any Linux machine running go-odio-api v0.16.1 or later with a D-Bus user session. See platform support for the tested architectures and distributions, and compatible hardware for full odio streamers.

The integration requires Home Assistant 2026.3 or later.

What a node exposes depends on the backends enabled in its go-odio-api configuration: audio, systemd services, MPRIS players, Bluetooth, power, and upgrade. Each backend is optional, and HA only creates the entities for the backends the node reports.

  1. Go to Settings → Marketplace in Home Assistant.

  2. Search for odio or use the direct link:

    Open in the Marketplace

  3. Select Install, then restart Home Assistant if asked.

Before Home Assistant 2026.11, the Marketplace was HACS, a separate integration to install first.

To install without the Marketplace, download the latest release, copy custom_components/odio_remote into your Home Assistant config/custom_components/ folder, and restart Home Assistant.

Install odio integration

Your odio nodes are auto-discovered via Zeroconf and show up under Settings → Devices & services with their hostname. Confirm the discovered node to add it.

To add a node manually, go to Settings → Devices & services → Add integration, search for Odio Remote, and enter the API URL (http://<ip>:8018 with the default port).

The setup then asks for:

  1. The SSE keepalive interval, 30 seconds by default.
  2. Optional service mappings to existing Home Assistant media players.

Both can be changed later. See options and mapping.

  • Phone and tablet: pair over Bluetooth, open pairing mode, and control playback from the Home Assistant companion app.
  • HTPC: start and stop Kodi or a browser kiosk from Home Assistant.
  • Desktop: control the volume of every desktop streaming to the node.
  • NAS: turn the NAS itself into an odio node.
  • Power and upgrade: shut down a node or apply an odio upgrade from Home Assistant.
  1. Go to Settings → Devices & services, open Odio Remote, and select Delete from the node’s menu.
  2. If you installed it from the Marketplace, open Odio Remote in Settings → Marketplace and select Uninstall from the menu.

Removing the integration does not change anything on the node: go-odio-api keeps running.