Integrations

Odeion integrates with Sonarr (for TV shows) and Radarr (for movies) to let users request new content directly from the Odeion interface. When a user submits a request, Odeion sends it to the appropriate service, which handles searching, downloading, and organizing the media files.

Setting Up Radarr

1. Go to Admin > Settings > Integrations.
2. Enter your Radarr server URL (for example, http://localhost:7878 or http://radarr:7878 if running in Docker).
3. Enter your Radarr API key (found in Radarr under Settings > General > Security).
4. Select a default quality profile and root folder. These determine where requested movies are stored and at what quality they are downloaded.
5. Save.

Setting Up Sonarr

Follow the same steps using your Sonarr URL and API key (Sonarr’s default port is 8989). Select a default quality profile and root folder for TV shows.

If both Radarr and Sonarr run in Docker alongside Odeion, make sure all containers are on the same Docker network and use the container service names as hostnames.

How Requests Work

Users with the Curator role or higher see a request option when browsing content that is not yet in the library. They can search for movies or TV shows by title, view results from TMDB, and submit a request.

The request is sent to Radarr or Sonarr depending on the content type. Once the download completes and the file appears in the library path, Odeion picks it up during the next library scan and automatically associates it with the request.

Request status (pending, downloading, available) is tracked in Odeion and visible to the user who made the request.

Network Access

Odeion needs HTTP access to your Sonarr/Radarr instances. If they are on the same machine or Docker network, use internal hostnames or IPs. If they are on separate machines, ensure the firewall allows connections on the appropriate ports.