mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-13 12:26:50 +00:00
Add Ombi integration (#10400)
* Add Ombi integration * Replace path with urlbase * Update source/_components/ombi.markdown Co-Authored-By: Klaas Schoute <klaas_schoute@hotmail.com> * Update source/_components/ombi.markdown Co-Authored-By: Klaas Schoute <klaas_schoute@hotmail.com> * Remove monitored_conditions and scan_interval * Adjust config and syntax, add services
This commit is contained in:
parent
7ad405dca4
commit
acf4db1d21
100
source/_components/ombi.markdown
Normal file
100
source/_components/ombi.markdown
Normal file
@ -0,0 +1,100 @@
|
||||
---
|
||||
title: "Ombi"
|
||||
description: "Instructions on how to set up the Ombi integration in Home Assistant."
|
||||
logo: ombi.png
|
||||
ha_category:
|
||||
- Sensor
|
||||
ha_release: "0.100"
|
||||
ha_iot_class: Local Polling
|
||||
---
|
||||
|
||||
The `Ombi` integration monitors data from your [Ombi](https://ombi.io) 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`:
|
||||
|
||||
```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
|
||||
|
||||
```yaml
|
||||
# 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. |
|
BIN
source/images/supported_brands/ombi.png
Normal file
BIN
source/images/supported_brands/ombi.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 20 KiB |
Loading…
x
Reference in New Issue
Block a user