https://github.com/maxdorninger/MediaManager
A modern selfhosted media management system for your media library
https://github.com/maxdorninger/MediaManager
Last synced: 6 months ago
JSON representation
A modern selfhosted media management system for your media library
- Host: GitHub
- URL: https://github.com/maxdorninger/MediaManager
- Owner: maxdorninger
- License: agpl-3.0
- Created: 2025-02-08T17:30:18.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-07-13T16:00:32.000Z (6 months ago)
- Last Synced: 2025-07-13T16:24:11.684Z (6 months ago)
- Language: Python
- Homepage: https://maxdorninger.github.io/MediaManager/introduction.html
- Size: 24.6 MB
- Stars: 532
- Watchers: 6
- Forks: 8
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ccamel - maxdorninger/MediaManager - A modern selfhosted media management system for your media library (Python)
README
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](https://maxdorninger.github.io/MediaManager/configuration-overview.html#configuration-overview)
## Support MediaManager
## Check out the awesome sponsors of MediaManager ❤️
## 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
- [x] 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](hhttps://maxdorninger.github.io/MediaManager/issues) for a full list of proposed features (and known issues).
## Screenshots
## 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)