Ombi


The Ombi integration monitors data from your Ombi instance.

Setup

This component needs to authenticate to your Ombi instance with either a user password or an api_key.

To find your api_key open the Ombi web interface. Navigate to Settings and then to Ombi, you should then be able to see your api_key.

If you want to use password authentication simply use the same password you normally use to login to Ombi. Alternatively, you can set up a separate local account in Ombi designated for Home Assistant. In order to do this, open the Ombi web interface. Navigate to User Management and then press Add User To Ombi. Input your desired user details and use the same details when configuring this integration.

Configuration

If you want to enable this sensor, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
ombi:
  host: OMBI_HOST
  username: OMBI_USERNAME
  password: OMBI_PASSWORD

Configuration Variables

host

(string)(Required)

The hostname or IP Address Ombi is running on.

username

(string)(Required)

Your Ombi username.

password

(string)(Exclusive)

Your Ombi password. password and api_key cannot be specified concurrently.

api_key

(string)(Exclusive)

Your Ombi API key. password and api_key cannot be specified concurrently.

port

(integer)(Optional)

The port Ombi is running on.

Default value:

5000

urlbase

(string)(Optional)

The Base URL path of your Ombi instance.

ssl

(boolean)(Optional)

Whether or not to use SSL when connecting to Ombi.

Default value:

false

Full example for the configuration

# Example configuration.yaml entry
ombi:
  host: OMBI_HOST
  username: OMBI_USERNAME
  api_key: OMBI_API_KEY
  port: OMBI_PORT
  urlbase: ombi/
  ssl: true

Services

Submit request services

Available services: submit_movie_request, submit_music_request, submit_tv_request

Service submit_movie_request

Searches and requests the closest matching movie.

Service data attribute Optional Description
name no Search parameter.

Service submit_music_request

Searches and requests the closest matching music album.

Service data attribute Optional Description
name no Search parameter.

Service submit_tv_request

Searches and requests the closest matching TV show.

Service data attribute Optional Description
name no Search parameter.
season yes Which season(s) to request. Must be one of first, latest or all. Defaults to latest.