This is an automated archive made by the Lemmit Bot.
The original was posted on /r/selfhosted by /u/TheWicklowWolf on 2025-03-14 13:11:50+00:00.
What is it?
It’s a Media Discovery and Download Hub which acts as add-on or extension for the Arr stack and more, designed to manage and obtain media both manually and automatically. Think of it as a media manager, recommendation and helper app.
What's the Problem?
I've made a start, but for long-term stability and maintainability, the project needs more contributors. It's highly modular, with separate services, making it easy for new developers to jump in and focus on specific areas.
Where to Start?
I’ve set up the organization on GitHub at and I’m happy to add people to the the poject . This way, the project won’t be dependent on any one individual. With enough developers, it will help keep the project alive and ensure long-term stability.
Why?
I’ve already worked on these services individually (check out my other projects here) and I would prefer to bring them all into a unified project for better management and collaboration. This way, further development can be streamlined in one place, rather than scattered across multiple repos.
🌍 Proposed MediaWolf Features:
Books (Readarr & Anna’s Archive)
✅ Missing List → Read from Readarr, fetch missing books and auto-download via Anna’s Archive
✅ Manual Search → Search Anna’s Archive and download books (user selection and defined file structure)
✅ Recommendations → Generate book suggestions based on Readarr library (using a background tasks to scrape from Goodreads) - with options to add or dismiss suggestions including filters and sorting
Movies (Radarr & TMDB)
✅ Recommendations → Read Radarr library and suggest similar movies via TMDB (with options to add or dismiss suggestions including filters and sorting)
✅ Manual Search → Search via TMDB with option to add to Radarr
TV Shows (Sonarr & TMDB)
✅ Recommendations → Read Sonarr library and suggest similar shows via TMDB (with options to add or dismiss suggestions including filters and sorting)
✅ Manual Search → Search via TMDB with option to add to Sonarr
Music (Lidarr, LastFM, yt-dlp, Spotify)
✅ Manual Search → Search Spotify for music and download via spotDL (which uses yt-dlp)
✅ Recommendations → Generate artist recommendations from LastFM based on Lidarr library (with options to add or dismiss suggestions including filters and sorting)
✅ Missing List → Read Lidarr library, fetch missing albums and download via yt-dlp
Downloads (via yt-dlp)
✅ Direct Download Page → Input YouTube or Spotify link and download video/audio using spotDL or yt-dlp
Subscriptions (via spotdl and yt-dlp)
✅ Schedule System → Subscribe to YouTube Channels, Spotify or YouTube Playlists and download on a schedule
🛠️ Tech Stack Overview
| Layer | Technology |
|
|
|
| Frontend | Bootstrap (JS/HTML/CSS) |
| Backend | Python with Flask |
| Database | SQLite (SQLAlchemy) |
| Scheduler | APScheduler (for cron-based scheduling) |
| Downloader | spotdl and yt-dlp |
| Containerization | Docker + Docker Compose |
📂 Proposed Project Structure
MediaWolf/
├── backend/
│ ├── __init__.py
│ ├── api/
│ │ ├── __init__.py
│ │ ├── auth_api.py
│ │ ├── books_api.py
│ │ ├── downloads_api.py
│ │ ├── logs_api.py
│ │ ├── movies_api.py
│ │ ├── music_api.py
│ │ ├── settings_api.py
│ │ ├── shows_api.py
│ │ ├── subscriptions_api.py
│ │ └── tasks_api.py
│ ├── db/
│ │ ├── __init__.py
│ │ ├── database_handler.py
│ │ ├── music_db_handler.py
│ │ └── music_models.py
│ ├── services/
│ │ ├── __init__.py
│ │ ├── config_services.py
│ │ ├── lastfm_services.py
│ │ ├── lidarr_services.py
│ │ ├── radarr_services.py
│ │ ├── readarr_services.py
│ │ ├── sonarr_services.py
│ │ ├── spotdl_download_services.py
│ │ ├── spotify_services.py
│ │ ├── subscription_services.py
│ │ ├── tasks.py
│ │ └── ytdlp_services.py
│ ├── utils/
│ │ ├── __init__.py
│ │ └── string_cleaner.py
│ ├── logger.py
│ └── main.py
├── docker/
│ ├── .dockerignore
│ ├── Dockerfile
│ └── requirements.txt
├── frontend/
│ ├── static/
│ │ ├── base_script.js
│ │ ├── base_style.css
│ │ ├── book_script.js
│ │ ├── favicon.png
│ │ ├── lidarr.svg
│ │ ├── logo.png
│ │ ├── logs_script.js
│ │ ├── movies_script.js
│ │ ├── music_script.js
│ │ ├── music_style.css
│ │ ├── settings_script.js
│ │ ├── shows_script.js
│ │ ├── subscriptions_script.js
│ │ ├── tasks_script.js
│ │ ├── theme_script.js
│ │ └── yt_dlp.png
│ └── templates/
│ ├── base.html
│ ├── books.html
│ ├── downloads.html
│ ├── login.html
│ ├── logs.html
│ ├── movies.html
│ ├── music.html
│ ├── settings.html
│ ├── shows.html
│ ├── subscriptions.html
│ └── tasks.html
├── docs/
│ └── screenshot.png
└── README.md
Edit:
Edit: Anyone interested, create a PR for whatever section you want to take on...
