Support This Project If you find this project helpful, please consider supporting it. Your contributions help maintain and improve the project. Any support is greatly appreciated! ❤️ https://buymeacoffee.com/vansmak Thank you for your support!

Mediarr for Home Assistant (inspired by upcoming media card) https://github.com/Vansmak/mediarr-card

Services

This integration provides services to interact with Overseerr/Jellyseerr. While the various trending/discover sensors and frontend card are optional, the base seer sensor is required to enable the services.

Minimum Required Configuration just to have overseer\jellyseer request services from ha

To use the seer request services, add this to your configuration.yaml:

mediarr:
  seer:
    url: your_seerr_url
    api_key: !secret seer_api_key

and for sensors:

sensor:
  - platform: mediarr
    seer:
      url: your_seerr_url
      api_key: your_api_key

Installation

HACS Installation

1. Open HACS
2. Go to "Integrations"
3. Click the three dots menu and select "Custom repositories"
4. Add this repository URL and select "Integration" as the category
5. Click "Add"
6. Find and install "Mediarr" from HACS
7. Restart Home Assistant

Manual Installation

1. Download the latest before hacs (can break)

2. Copy all contents from custom_components/mediarr/ to /config/custom_components/mediarr/

3. Restart Home Assistant

Configuration

Step 1: Configure Sensors

Add one or more of the following sensors to your configuration.yaml, sensors: Customizable Filters: Control content discovery with granular options ** have multiple instances for sonarr and radarr (2 each)

sensor:
  - platform: mediarr
    seer: 
      url: localhost
      api_key: your_api_key
      max_items: 45  #example how many items you want in sensor, you can chosse a different amount in card
      tmdb_api_key: "your_tmdb_api_key" 
      trending: true # Optional     
      discover: true  # Optional
      popular_movies: false  # Optional, recommended to use tmdb for popular
      popular_tv: false # Optional, recommended to use tmdb for popular

    plex:  # Optional
      url: Plex url
      token: your_token
      max_items: 45  #example how many items you want in sensor, you can chosse a different amount in card
      tmdb_api_key: "your_tmdb_api_key"
      language: en #default

    jellyfin:  # Optional
      url: jellyfin url
      token: your_api_key 
      max_items: 45  #example how many items you want in sensor, you can chosse a different amount in card
      tmdb_api_key: "your_tmdb_api_key"
      language: en #default

    sonarr:  # Optional
      url: http://localhost:8989
      api_key: your_sonarr_api_key
      max_items: 45  #example how many items you want in sensor, you can chosse a different amount in card
      days_to_check: 60 #example

    sonarr2:  # Optional
      url: http://localhost:8989
      api_key: your_sonarr_api_key
      max_items: 45  #example how many items you want in sensor, you can chosse a different amount in card
      days_to_check: 60  #example

    radarr:  # Optional
      url: http://localhost:7878
      api_key: your_radarr_api_key
      max_items: 45  #example how many items you want in sensor, you can chosse a different amount in card
      days_to_check: 60 #breaking change

    radarr2:  # Optional
      url: http://localhost:7878
      api_key: your_radarr_api_key
      max_items: 45  #example how many items you want in sensor, you can chosse a different amount in card
      days_to_check: 60 #breaking change
      
    
    trakt:  # Optional
      client_id: "your_client_id"
      client_secret: "your_client_secret"
      tmdb_api_key: "your_tmdb_api_key"  # Required for posters
      trending_type: both  # Options: movies, shows, both
      max_items: 45  #example how many items you want in sensor, you can chosse a different amount in card
     
    
    tmdb:  # Optional
      tmdb_api_key: "!secret tmdb_api_key"  #may need quotes
      trending_type: all  # Options: movie, tv, all
      max_items: 45  #example how many items you want in sensor, you can choose a different amount in card
      trending: true          # Default endpoint
      now_playing: true       # Optional
      upcoming: true          # Optional
      on_air: true            # Optional
      airing_today: false     # Optional
      popular_movies: true
      popular_tv: true
      filters:
        min_year: 2020  # Only show content from 2020 onwards
        exclude_talk_shows: true
        exclude_genres: [10763, 10764, 10767]

Sensor Configuration

• max_items: Number of items to display (default: 45)

• days_to_check: Days to look ahead for upcoming content (Sonarr only, default: 90)

• trending_type: Content type to display for Trakt and TMDB

• Available Filters

• hide_existing: Toggle library content filtering (default: true)

• min_year: Minimum release year for content

• exclude_talk_shows: Remove talk shows and similar content

• exclude_non_english: Show only English content

• exclude_genres: List of genre IDs to filter out

Common Genre IDs to Exclude

10763: News 10764: Reality 10767: Talk Shows 35: Comedy (if you want to filter out comedy) 99: Documentary (if you prefer scripted content)

Step 3: if you want a front-end, install Mediarr-card from https://github.com/Vansmak/mediarr-card

Add the Card

Getting API Keys

Plex

1. Get your Plex token from your Plex account settings
2. More details at Plex Support

Sonarr/Radarr

1. Go to Settings -> General
2. Copy your API key

Trakt

1. Create an application at Trakt API
2. Get your client ID and secret

TMDB

1. Create an account at TMDB
2. Request an API key from your account settings

Overseer\Jellyseer

1. Go to Settings -> General
2. Copy your API key

Upcoming Features

Contributors

Vansmak aka Vanhacked FNXPT

License

MIT