home-assistant.io/source/_integrations/ombi.markdown

title, description, logo, ha_category, ha_release, ha_iot_class

title	description	logo	ha_category	ha_release	ha_iot_class
Ombi	Instructions on how to set up the Ombi integration in Home Assistant.	ombi.png	Sensor	0.100	Local Polling

The Ombi integration monitors data from your Ombi instance.

Setup

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.

Configuration

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

# Example configuration.yaml entry
ombi:
  api_key: OMBI_API_KEY
  host: OMBI_HOST
  username: OMBI_USERNAME

{% configuration %} api_key: description: Your Ombi API key. required: true type: string host: description: The hostname or IP Address Ombi is running on. required: true type: string username: description: Your Ombi username. required: true type: string port: description: The port Ombi is running on. required: false default: 5000 type: integer urlbase: description: The Base URL path of your Ombi instance. required: false type: string ssl: description: Whether or not to use SSL when connecting to Ombi. required: false default: false type: boolean {% endconfiguration %}

Full example for the configuration

# Example configuration.yaml entry
ombi:
  api_key: OMBI_API_KEY
  host: OMBI_HOST
  username: OMBI_USERNAME
  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.