# Mediastarr

Mediastarr is a self-hosted automation tool that periodically searches for missing content and quality upgrades across your Sonarr and Radarr instances. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/1684/mediastarr

## Description

Mediastarr is a self-hosted automation tool that periodically searches for missing content and quality upgrades across your Sonarr and Radarr instances. It filters candidates by IMDb rating and target resolution, applies configurable cooldowns and daily search limits, records every search in a SQLite history, and posts rich Discord webhook notifications with posters and fanart. Built for homelab media managers who want their libraries kept current and upgraded without manual release hunting, it requires no config file editing thanks to its first-run browser wizard.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

52/100 (Fair), based on 4 of 5 factors.
- Maintained: 59 (last commit 188 days ago)
- Popular: 30 (32 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- GitHub: https://github.com/kroeberd/mediastarr
- Official website: https://mediastarr.de
- Unraid: https://ca.unraid.net/apps/mediastarr-0x5hv0p09wgq79?q=Mediastarr

## Common questions

### What default port does Mediastarr use?

The dashboard uses localhost:7979.

### Can it be connected to multiple Sonarr and Radarr instances?

Yes, it supports multiple Sonarr and Radarr instances. You can give each instance a custom name and it appears with its own card.

### What data does Mediastarr keep for search history?

It stores a SQLite history containing title, year, type, result, search count, and timestamps.

### How can I stop it from re-searching the same missing item too often?

Set a cooldown from 1 to 365 days, a daily search limit, and optional jitter. Items are picked randomly each cycle and the cooldown resets automatically.

### Does it detect downloads that are stuck in Sonarr or Radarr?

A stalled download monitor detects stuck downloads and triggers a new search using a queue API-based flow.

### How can I protect the dashboard and API with a password?

Set the MEDIASTARR_PASSWORD environment variable to protect the dashboard and API. CSRF protection is included.

---
Source: Our Local Host (https://ourlocalhost.com/app/1684/mediastarr), the self-hosted and open-source app directory.
