Sportarr is a self-hosted sports PVR that monitors sports leagues, searches Usenet and torrent indexers for event releases, and organizes the results into a Plex, Jellyfin, or Emby library — built for people who collect sports events the way Sonarr and Radarr handle series and films.
What it is
Sportarr is a C# application in the Miscellaneous / Media & Streaming category, released under GPL-3.0 and distributed as a Docker image plus native builds for Windows, macOS, and Linux. The project began as a fork of Sonarr in October 2025 and was rewritten shortly afterwards; the great majority of the code is original, but parts remain derived from Sonarr, and the Sonarr team's copyright notices are retained in COPYRIGHT.md. It presents itself plainly as a PVR for sports: it monitors leagues, searches indexers for releases, and handles file renaming, organization, and media server integration.
The concrete problem it solves is that general-purpose media automation does not model sporting events. Sonarr tracks series and Radarr tracks films, but a fight card, a race, or a match is a one-off event with its own naming and multi-part structure. Sportarr tracks events across all major sports, including fighting sports, football, soccer, basketball, and racing, then applies customizable naming schemes that account for multi-part events in fighting sports. It replaces the manual loop of watching for a release, downloading it, and renaming and filing it by hand.
Key capabilities
- Monitors sports leagues and tracks events across all major sports, including fighting sports, football, soccer, basketball, and racing.
- Searches Usenet and torrent indexers automatically and upgrades quality when better releases appear.
- Organizes files with customizable naming schemes, including multi-part handling for fighting sports events.
- Integrates with Plex, Jellyfin, and Emby through dedicated metadata agents, drawing event metadata associated with TheSportsDB.
- Records live events from IPTV sources with automatic scheduling, currently marked alpha.
- Fetches subtitles through Bazarr and sends notifications via Discord, ntfy, Apprise, webhooks, or custom scripts.
- Exposes an Application API for tools integrating with Sportarr, alongside a live metadata API explorer on the wiki.
Who uses it and how
- Self-hosters running the Docker image who mount
/config and /data and set PUID, PGID, UMASK, and TZ to match their host permissions and timezone.
- TrueNAS SCALE, HexOS, and Unraid users who install Sportarr directly from the platform app catalogs rather than composing the container by hand.
- Existing Sonarr-style stacks, where Sportarr sits beside Prowlarr for indexers, Bazarr for subtitles, Maintainerr, Homepage, and autobrr, as documented in the integrations section of the wiki.
- Households serving a Plex, Jellyfin, or Emby library that needs sports events filed and matched like the rest of the collection.
- IPTV users who schedule and record live events, a workflow still labeled alpha and best treated as experimental.
Getting started
Run the sportarr/sportarr:latest Docker image — the README provides a full docker-compose snippet mapping port 1867 and the /config and /data volumes — then open http://your-server-ip:1867 and follow the initial setup guide. Native builds for Windows, macOS, and Linux are on the releases page.
How it compares
Sportarr sits in the same family as Sonarr and Radarr, and it is designed to slot into the surrounding toolchain they share: Prowlarr for indexers, Bazarr for subtitles, autobrr for release grabbing, and Maintainerr for library cleanup. Where those tools cover series and films, Sportarr covers sporting events, with event-specific tracking and multi-part naming that the others do not model.
When to use it — and when not to
A self-hoster must run the container or a native build and hold accounts on Usenet or torrent indexers; an IPTV source is needed for the recording feature, and Bazarr is needed for subtitles. The IPTV DVR path is explicitly alpha, so anyone who needs dependable scheduled recording should wait or test carefully. Anyone unwilling to self-host, or without indexers to search, has no use for it.
project readme (upstream, from github) — read inline

Sports PVR for Usenet and Torrents
Like Sonarr & Radarr, but for sports events. Monitors sports leagues, searches your indexers
for releases, and handles file renaming, organization, and media server integration.
Support the Project

What It Does
- Tracks events across all major sports (fighting sports, football, soccer, basketball, racing, etc.)
- Searches Usenet and torrent indexers automatically and upgrades quality when better releases appear
- Organizes files with customizable naming schemes, including multi-part events for fighting sports
- Integrates with Plex, Jellyfin, and Emby through dedicated metadata agents
- Records live events from IPTV sources with automatic scheduling (alpha)
- Fetches subtitles through Bazarr and notifies via Discord, ntfy, Apprise, webhooks, or custom scripts
Quick Start
version: "3.8"
services:
sportarr:
image: sportarr/sportarr:latest
container_name: sportarr
environment:
- PUID=99
- PGID=100
- UMASK=022
- TZ=America/New_York
volumes:
- /path/to/sportarr/config:/config
- /path/to/data:/data
ports:
- 1867:1867
restart: unless-stopped
Open http://your-server-ip:1867 and follow the Initial Setup guide.
Not on Docker? Native builds for Windows, macOS, and Linux are on the releases page, and Sportarr is in the TrueNAS SCALE, HexOS, and Unraid app catalogs. Full details in the installation guide.
Documentation
Everything lives on the wiki at wiki.sportarr.net:
Support
Project Activity

Star History

Contributors
Sportarr is made better by everyone who has contributed code. Thank you.
See the full contributor graph, plus everyone helping with testing and bug reports on Discord.
Sponsors
Sportarr is free and self-funded. If it saves you time, a one-time or monthly contribution keeps it moving, and every supporter shows up here.


Sportarr is supported by:
License
GNU GPL v3 - see LICENSE.md and COPYRIGHT.md.
Acknowledgements
Sportarr began as a fork of Sonarr in October 2025. The
application was rewritten shortly afterwards and the great majority of the code here is
original, but parts of it are still derived from Sonarr and the project would not exist
without the years of work that went into it first.
Thank you to the Sonarr Team and everyone who has contributed to Sonarr. Their copyright notices
are retained in COPYRIGHT.md, and Sportarr is released under the same GPL-3.0
license.