Giter Club home page Giter Club logo

ha-overseerr's Introduction

What is this?

This project is a fork of @vaparr's ha-overseer custom integration.
The reason for the fork is the inactivity of the project and the adaption to jellyseerr


title: Jellyseer description: Instructions on how to set up the Jellyseer integration in Home Assistant. ha_category:

  • Sensor ha_domain: jellyseer

needs to be modified

The Overseerr integration monitors data from your Overseerr instance.

Setup

Install of this component should be done via HACS

Restart HA


This component needs to authenticate to your Overseerr instance using your api_key.

To find your api_key open the Overseerr web interface. Navigate to Settings, 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
overseerr:
  host: OVERSEERR_HOST
  port: OVERSEERR_PORT
  api_key: OVERSEERR_API_KEY
  scan_interval: 600
{% configuration %}
host:
  description: The hostname or IP Address Overseerr is running on.
  required: true
  type: string
api_key:
  description: Your Overseerr API key. 
  required: true
  type: string
port:
  description: The port Overseerr is running on.
  required: false
  default: 5055
  type: integer
ssl:
  description: Whether or not to use SSL when connecting to Overseerr.
  required: false
  default: false
  type: boolean
scan_interval:
  description: Polling interval for Overseerr in seconds
  required: false
  default: 60
  type: integer
{% endconfiguration %}

Full example for the configuration

# Example configuration.yaml entry
overseerr:
  host: 192.168.1.62
  port: 5055
  api_key: MTYwODIpppppppppppppppYzLTI0OqqqqqqqqqqqqzIwLeeeeeee==

Services

Submit request services

Available services: submit_movie_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_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.

WebHook support

You can enable Webhook support in Overseerr to enable faster pending sensor updates.

In overseerr, navigate to Settings -> Notifications > Webhook

Check Enable Agent

for the Webhook URL use:

{{HA SERVER URL}}/api/webhook/{{OVERSEERR API KEY}}

http://homassist.local:8123/api/webhook/MTYwODIpppppppppppppppYzLTI0OqqqqqqqqqqqqzIwLeeeeeee==

Select only the boxes "Media Requested", "Media Approved"

  • You will also want to have 'Enable Notifications for Auto-Approved Requests' checked in the global notifications area

  • payload can be left as default

Authorization Header will most likley need to be left blank.

With webhooks enabled, you dont really need to poll overseerr anymore, so we suggest setting the scan_interval to a large value like 600 or more

ha-overseerr's People

Contributors

christophcaina avatar doctarrwho avatar emalton avatar infi-st avatar vaparr avatar zuluwhiskey avatar

Stargazers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.