MediaManager

Modern management system for your media library
Explore the docs »
Report Bug · Request Feature

MediaManager is modern software to manage your TV and movie library. It is designed to be a replacement for Sonarr, Radarr, Overseer, and Jellyseer. It supports TVDB and TMDB for metadata, supports OIDC and OAuth 2.0 for authentication and supports Prowlarr and Jackett. MediaManager is built first and foremost for deployment with Docker, making it easy to set up. It also provides an API to interact with the software programmatically, allowing for automation and integration with other services.

## Quick Start ``` wget -O docker-compose.yaml https://raw.githubusercontent.com/maxdorninger/MediaManager/refs/heads/master/docker-compose.yaml # Edit docker-compose.yaml to set the environment variables! docker compose up -d ``` ### [View the docs for installation instructions and more](https://maxdorninger.github.io/MediaManager/configuration-overview.html#configuration-overview) ## Roadmap - [x] support for more torrent indexers - [x] fully automatic downloads - [x] add tests - [x] add more logs/errors - [x] make API return proper error codes - [x] optimize images for web in the backend - [x] responsive ui - [x] automatically update metadata of shows - [x] automatically download new seasons/episodes of shows - [x] add fallback to just copy files if hardlinks don't work - [x] add check at startup if hardlinks work - [x] create separate metadata relay service, so that api keys for TMDB and TVDB are not strictly needed - [x] support for movies - [x] expand README with more information and a quickstart guide - [x] improve reliability of scheduled tasks - [x] add notification system - [x] add sequence diagrams to the documentation - [ ] provide example configuration files - [ ] make media sorting algorithm configurable - [ ] add usenet support - [ ] add in-depth documentation on the architecture of the codebase - [ ] make indexer module multithreaded - [ ] add support for deluge and transmission - [ ] add delete button for movies/TV shows - [ ] rework prowlarr module (select which indexers to use, etc.) - [ ] _maybe_ rework the logo - [ ] _maybe_ add support for configuration via toml/yaml config file See the [open issues](hhttps://maxdorninger.github.io/MediaManager/issues) for a full list of proposed features (and known issues). ## Screenshots ![Screenshot 2025-07-02 174732](https://github.com/user-attachments/assets/49fc18aa-b471-4be8-983e-c0ab240dfb73) ![Screenshot 2025-07-02 174342](https://github.com/user-attachments/assets/3a38953d-d0fa-4a7e-83d0-dd6e6427681c) ![Screenshot 2025-07-02 174616](https://github.com/user-attachments/assets/c3af4be8-b873-448c-8a4d-0d5db863aec7) ![Screenshot 2025-07-02 174416](https://github.com/user-attachments/assets/0d50f53b-64da-4243-8408-1d6fc85fe81b) ![Screenshot 2025-06-28 222908](https://github.com/user-attachments/assets/193e1afd-dabb-42a2-ab28-59f2784371c7) ## Developer Quick Start ```bash pip install uv uv venv # Activate the virtual environment uv pip install -e . ``` ```bash docker compose up db -d ``` ```bash uv run alembic upgrade head ``` ### Get the frontend up and running ```bash cd /web && npm install ``` ### Now start the backend and frontend ```bash fastapi dev /media_manager/main.py --reload --host ``` ```bash cd /web && npm run dev ``` ## License Distributed under the AGPL 3.0. See `LICENSE.txt` for more information. ## Acknowledgments * [Thanks to Pawel Czerwinski for the image on the login screen](https://unsplash.com/@pawel_czerwinski)