Files
MediaManager/README.md
Maximilian Dorninger 60fa1f9873 Merge pull request #48 from maxdorninger/add-configuration-via-toml-file
Add configuration via toml file and enhance documentation
2025-07-11 13:42:51 +02:00

5.2 KiB


Logo

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   
   wget -O docker-compose.yaml https://raw.githubusercontent.com/maxdorninger/MediaManager/refs/heads/master/config.toml
   # you probably need to edit the config.toml file, for more help see the documentation
   docker compose up -d

View the docs for installation instructions and more

Support MediaManager

Sponsor @maxdorninger Buy Me A Coffee

Check out the awesome sponsors of MediaManager ❤️

Aljaž Mur Eržen   Luis Rodriguez  

Roadmap

  • support for more torrent indexers
  • fully automatic downloads
  • add tests
  • add more logs/errors
  • make API return proper error codes
  • optimize images for web in the backend
  • responsive ui
  • automatically update metadata of shows
  • automatically download new seasons/episodes of shows
  • add fallback to just copy files if hardlinks don't work
  • add check at startup if hardlinks work
  • create separate metadata relay service, so that api keys for TMDB and TVDB are not strictly needed
  • support for movies
  • expand README with more information and a quickstart guide
  • improve reliability of scheduled tasks
  • add notification system
  • add sequence diagrams to the documentation
  • add usenet support
  • provide example configuration files
  • make media sorting algorithm configurable
  • 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 for a full list of proposed features (and known issues).

Screenshots

Screenshot 2025-07-02 174732 Screenshot 2025-07-02 174342 Screenshot 2025-07-02 174616 Screenshot 2025-07-02 174416 Screenshot 2025-06-28 222908

Developer Quick Start

  pip install uv
  uv venv
  # Activate the virtual environment
  uv pip install -e .
docker compose up db -d
uv run alembic upgrade head

Get the frontend up and running

cd /web && npm install

Now start the backend and frontend

fastapi dev /media_manager/main.py --reload --host
cd /web && npm run dev

License

Distributed under the AGPL 3.0. See LICENSE.txt for more information.

Acknowledgments