Seerr Request Card

A custom Home Assistant Lovelace card for searching movies and TV shows and requesting them through the Seerr (Overseerr) integration — without leaving your dashboard.

---

Overview

Type a title, get a list of matches, tap Request. That's it.

• Live search against your Seerr/Overseerr instance as you type
• Movies and TV shows, with media type and (for TV) first-air year shown
• One-tap request, with per-item loading state and a native HA toast on success/failure
• Items already available, pending, or processing in Seerr are shown as such instead of a clickable button
• Visual editor with a proper config-entry picker — no need to hand-type IDs

Requirements

This card is a frontend companion to the Seerr integration built into Home Assistant core — it does not talk to Seerr/Overseerr directly. Set up and configure that integration first: Settings → Devices & Services → Add Integration → Seerr. See the integration docs if you haven't done this yet.

Requires Home Assistant 2026.8 or newer — that's when the integration's search_media and request_media actions (which this card is built entirely on) were added. On older versions the integration exists but this card won't work.

Installation

HACS

This isn't in the default HACS store. Add it as a custom repository:

1. HACS → ⋮ (top right) → Custom repositories.
2. Repository: https://github.com/willmakenoise/ha_seerr_card, category Dashboard.
3. Install Seerr Request Card, then add the Lovelace resource HACS prompts you for (it does this automatically).

Manual

1. Download seerr-request-card.js from the latest release.
2. Copy it to <config>/www/seerr-request-card.js.
3. Add a resource entry (Settings → Dashboards → Resources, or in configuration.yaml under lovelace: resources:):

resources:
  - url: /local/seerr-request-card.js
    type: module

Configuration

Add the card via the dashboard's Add Card picker (search for "Seerr Request Card") and use the visual editor to pick your Seerr instance — it's auto-selected if you only have one configured. Or write YAML directly:

type: custom:seerr-request-card
config_entry_id: 01JXXXXXXXXXXXXXXXXXXXXXXX
name: Request Something

Options

Name	Type	Required	Description
type	string	Required	custom:seerr-request-card
config_entry_id	string	Required	The Seerr config entry to search/request against. Pick it via the visual editor, or find it under Developer Tools → Actions → overseerr.search_media (switch to YAML mode to see the raw ID).
name	string	Optional	Card header text. Defaults to "Seerr Request Card".

Known limitations

These come from the underlying python_overseerr client library used by the Seerr integration, not from this card:

• No poster/thumbnail images. Search results don't carry a poster path in the current library version, so results show a generic movie/TV icon instead of artwork.
• No release year for movies. TV shows show their first-air year; movies don't currently expose a release date through this library.
• Requesting already-available media can fail server-side. Overseerr's request endpoint returns a different response shape for media it already has, which the client library doesn't parse. This card avoids calling it for items already known to be available/pending/processing by reading their status from the search results — but if you hit a MissingField error in your Home Assistant log regardless, that's this upstream issue, not the card.

Development

Prerequisites

Tool	Version	Notes
Node.js	24
Yarn	4	Managed via Corepack

Quick start

git clone https://github.com/willmakenoise/ha_seerr_card.git
cd ha_seerr_card
yarn install
yarn start   # watches src/ and rebuilds dist/seerr-request-card.js, serving it at :5001

Point a running Home Assistant instance at the dev build as a Lovelace resource (http://localhost:5001/seerr-request-card.js, type module), or symlink dist/seerr-request-card.js into <config>/www/ and use /local/seerr-request-card.js.

A devcontainer (.devcontainer/) is also available, which brings up a local Home Assistant instance with the dev build wired in automatically — see .devcontainer/devcontainer.json.

Scripts

Command	Description
yarn start	Development watcher with hot rebuild
yarn build	Lint, then production bundle (minified)
yarn lint	ESLint across src/

Project structure

src/
├── seerr-request-card.ts   # Card element — search UI, service calls
├── editor.ts                # Visual editor (config-entry picker)
├── types.ts                 # Config + Overseerr response shapes
├── const.ts                 # CARD_VERSION
└── localize/                # i18n strings
dist/
└── seerr-request-card.js    # Build output — this is what HA loads

Releasing

Publishing a GitHub release (tag vX.Y.Z) triggers .github/workflows/release.yml, which bumps package.json and CARD_VERSION to match the tag, builds, and attaches seerr-request-card.js to the release. HACS installs from that release asset.

---