How maxdorninger/mediamanager works
MediaManager is a web-based manager for TV and movie libraries. Users browse or add media, search metadata and indexers, initiate downloads, and manage imports and library items. The backend separates movie and TV workflows from shared media services, torrent handling, persistence, authentication, and notifications. README capabilities include TMDB/TVDB support and OAuth/OIDC; these integration branches are represented at subsystem level where their runtime wiring was not excerpted. Dashed links mark relationships documented only generally or not shown in sampled source.
Main entry points: main.py API application · movies/service.py Movie workflow · tv/service.py TV workflow · common/service.py Shared media service
Components 22
User interface
- Web application
web/src/routes
API and identity
- API application
media_manager/main.py - Authentication
media_manager/auth
Media workflows
- Movie workflow
media_manager/movies/service.py - TV workflow
media_manager/tv/service.py - Shared media service
media_manager/common/service.py - Metadata providers
media_manager/metadataProvider
Search and downloads
- Indexer search
media_manager/indexer/service.py - Indexer adapters
media_manager/indexer/indexers - Download workflow
media_manager/torrent/service.py - Download clients
media_manager/torrent/manager.py
State and automation
- Movie persistence
media_manager/movies/repository.py - TV persistence
media_manager/tv/repository.py - Torrent persistence
media_manager/torrent/repository.py - Notifications
media_manager/notification/manager.py - Scheduled tasks
media_manager/scheduler.py - Database
media_manager/database
Other components
- Library user
- TMDB and TVDB
- Indexer services
- Download services
- Notification services
Connections 30
- Library user → Web application: uses
README.md - Web application → API application: requests API
- API application → Authentication: registers routes
media_manager/main.py - API application → Movie workflow: registers routes
media_manager/main.py - API application → TV workflow: registers routes
media_manager/main.py - API application → Notifications: registers routes
media_manager/main.py - Shared media service → Indexer search: uses search
media_manager/common/service.py - Shared media service → Download workflow: uses downloads
media_manager/common/service.py - Shared media service → Notifications: sends alerts
media_manager/common/service.py - Movie workflow → Shared media service: delegates
media_manager/movies/service.py - TV workflow → Shared media service: delegates
media_manager/tv/service.py - Movie workflow → Indexer search: searches releases
media_manager/movies/service.py - TV workflow → Indexer search: searches releases
media_manager/tv/service.py - Movie workflow → Movie persistence: persists movies
media_manager/movies/service.py - TV workflow → TV persistence: persists shows
media_manager/tv/service.py - Movie workflow → Download workflow: starts downloads
media_manager/movies/service.py - TV workflow → Download workflow: starts downloads
media_manager/tv/service.py - Movie workflow → Metadata providers: gets metadata
media_manager/movies/service.py - TV workflow → Metadata providers: gets metadata
media_manager/tv/service.py - Metadata providers → TMDB and TVDB: queries providers
README.md - Indexer search → Indexer adapters: dispatches searches
media_manager/indexer/service.py - Indexer adapters → Indexer services: queries
- Download workflow → Download clients: dispatches downloads
media_manager/torrent/service.py - Download clients → Download services: uses clients
media_manager/torrent/manager.py - Download workflow → Torrent persistence: saves torrents
media_manager/torrent/service.py - Notifications → Notification services: sends notifications
media_manager/notification/manager.py - Movie persistence → Database: stores records
- TV persistence → Database: stores records
- Torrent persistence → Database: stores records
media_manager/torrent/repository.py - API application → Scheduled tasks: starts tasks
media_manager/main.py