Sortarr is a read-only analytics and organisation tool for media libraries. It helps you identify missing media, mismatches, and optimisation opportunities using live data from providers like Sonarr, Radarr, Plex, Jellyfin, Tautulli, Jellystat and Streamystats.
Sortarr provides a data-driven management layer for your media library, using optional playback behaviour data to help you to optimise your library.
Sortarr does not modify, move, or rename your media. It can analyse Sonarr and Radarr libraries, or use Plex, Jellyfin, or Emby directly as a media source, and incorporates playback and history data to present actionable insights.
basic, basic_local_bypass, or externalSortarr is designed for users who:


Setup, deployment, reverse-proxy, and provider guides live in the Project wiki.
Project wiki: https://github.com/Jaredharper1/Sortarr/wiki
basic: Sortarr challenges every client with its own Basic Auth credentialsbasic_local_bypass: Sortarr still requires Basic Auth credentials, but allowed direct local peers can bypass the browser auth prompt. This mode is only supported with direct access and is intentionally invalid behind reverse proxies.external: a trusted reverse proxy handles login and passes the configured upstream auth header; Sortarr does not require its own Basic Auth prompt in steady-state access. This mode is only supported behind a trusted reverse proxy and is not intended for direct exposure.Supported for 0.9.0:
* basic with direct access
* basic behind supported reverse-proxy paths
* basic_local_bypass only with direct access
* external only behind a trusted reverse proxy with an explicit non-wildcard trusted proxy setting
Not supported for 0.9.0:
* basic_local_bypass behind reverse proxies
* external in direct mode
* external with wildcard-only trusted proxy configuration
Sortarr will never:
All operations are read-only and safe.
Enjoying the project? Looking for a way to contribute?
The best way to support Sortarr is simply to use it. If you encounter bugs or issues, please report them. Feature requests and suggestions are also very welcome.
Sortarr is a free project and I will never require donations to support or maintain it.
That said, if you would like to support me directly, in the interest of transparency I should mention that any donations will most likely be spent on beer and beer-related activities. If you're still willing to contribute, I appreciate it greatly.
$ claude mcp add Sortarr \
-- python -m otcore.mcp_server <graph>