Medusa
Medusa is an automatic TV show library manager that handles monitoring, downloading, renaming, and organizing episodes with support for multiple indexers and providers.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
Automatically monitor, download, and organize TV shows with multiple indexer and provider support.
Core Features
- Supports TVDB, TVMaze, and TMDB indexers
- Manual episode search with filters (provider, seeds, release group)
- Manual subtitle search for missed matches
- Auto rename, sort, and generate Kodi metadata
- Trakt sync for watchlist and episode status
What It Can't Do
- •Backup existing sickbeard.db before first run. Delete cache.db and failed.db to avoid conflicts. Install MediaInfo (Linux: manual) for better video metadata extraction.
Use Cases
- TV show enthusiasts who want automatic downloads at desired quality
- Users with Kodi or other media centers needing automated library updates
- Power users managing multiple torrent/NZB providers in one dashboard
Detailed Introduction
Medusa is an open-source automatic TV show library manager that handles the entire workflow from monitoring new episodes to downloading, renaming, and organizing them. It supports multiple indexers (TVDB, TVMaze, TMDB), manual search with detailed filters, subtitle management, and integration with media centers like Kodi. Built on Python 3.9+, it offers faster processing, anime support, and extensive provider compatibility (torrent/NZB). Docker images are available for easy deployment across platforms.
Troubleshooting & FAQ (1)
TroubleshootingWhy does Medusa show English title and description when adding non-English shows from TMDB?
This is a known bug where TMDB indexing in Medusa ignores the selected info language for show title and overview. The issue was fixed in PR #12202. Upgrade Medusa to the latest version to resolve it. As a temporary workaround, use TVDB as the indexer for non-English shows, or manually edit the title after adding.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Install Python 3.9-3.13 or use Docker
Step 2: Clone repo & run `python start.py` (or Docker: `docker run -d -p 8081:8081 pymedusa/medusa`)
Step 3: Open http://localhost:8081 in browser, follow setup wizard to add shows and configure downloader
- Step 1: Install Python 3.9-3.13 or use Docker
- Step 2: Clone repo & run `python start.py` (or Docker: `docker run -d -p 8081:8081 pymedusa/medusa`)
- Step 3: Open http://localhost:8081 in browser, follow setup wizard to add shows and configure downloader
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Delete the Medusa folder (or Docker containers/images) and remove database files (sickbeard.db, cache.db, failed.db).
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
1 FAQ
Similar Projects
yt-dlp
A feature-rich command-line audio/video downloader supporting thousands of sites. Fast, reliable, and actively maintained fork of youtube-dl.
MoneyPrinterTurbo
An open-source tool that uses AI LLMs to automatically generate high-quality short videos from a topic or keyword.
obs-studio
Free and open-source software for video recording and live streaming. High performance, real-time capture, compositing, encoding, and broadcasting.