Medusa

Automatic Video Library Manager for TV Shows. It watches for new episodes of your favorite shows, and when they are posted it does its magic.

Exclusive features

Supports TVMaze and TMDB indexers
Manual search episodes (you choose what to snatch based on all kind of info: provider, seeds, release group)
Manual search for subtitles (useful when subtitle has low score because of typo in filename or alternative title)
Support for Python 3
Uses 'guessit' library to parse and enrich existing info (more precise than regexes)
Improved Anime shows support
Faster DailySearcher|Backlog|Find propers as we only process new items. Already processed items are discarded.
Option to clean Kodi library when replacing existing files
Better quality explanations and consistent quality code in all threads
See on the fly if your backlogged episodes will be increased/reduced while changing qualities
Postpone Post Processing until Medusa downloads wanted subtitle (useful to only show media if subtitle available)
Clean up any leftover files/folders if media file is deleted
Nightly showupdater updates only the season of the show, which has been updated by the indexer, for tvdb and tmdb.

Features

Kodi/XBMC library updates, poster/banner/fanart downloads, and NFO/TBN generation
Sync your shows with Trakt. Keep shows/episode updated in Trakt watchlist
Configurable automatic episode renaming, sorting, and other processing
Easily see what episodes you're missing, are airing soon, and more
Automatic torrent/nzb searching, downloading, and processing at the qualities you want
Largest list of supported torrent and nzb providers, both public and private
Can notify Kodi, XBMC, Growl, Trakt, Twitter, and more when new episodes are available
Searches TheTVDB.com and AniDB.net for shows, seasons, episodes, and metadata
Episode status management allows for mass failing seasons/episodes to force retrying
DVD Order numbering for returning the results in DVD order instead of Air-By-Date order
Allows you to choose which indexer to have Medusa search its show info from when importing
Automatic XEM Scene Numbering/Naming for seasons/episodes
Available for any platform, uses a simple HTTP interface
Specials and multi-episode torrent/nzb support
Automatic subtitles matching and downloading
Improved failed download handling
DupeKey/DupeScore for NZBGet 12+
Real SSL certificate validation

Dependencies

To run Medusa from source you will need one of these Python versions:

Python 3 – 3.7.0 and newer

Installation - direct

Start here to read the installation guides for different setups.

Installation - Docker

There's a direct build available on Dockerhub which is updated directly from this repo on every commit to master.

For alternate architectures, the linuxserver.io team have kindly produced docker images for X86, armhf and aarch64 platforms. This is built from an older intermediary Dockerfile.

X86 - Dockerhub, Github
armhf - Dockerhub, Github
aarch64 - Dockerhub, Github

Medusa Issue Tracker

FAQ

Wiki

Discord

Important

Before using this with your existing database (sickbeard.db) please make a backup copy of it and delete any other database files such as cache.db and failed.db if present. We HIGHLY recommend starting out with no database files at all to make this a fresh start but the choice is at your own risk.

Supported providers

A partial list can be found here. Jackett is supported, however it must be configured as follows.

Special Thanks to:

LinuxServer.io for the alternative Docker image.

News and Changelog

news.md has moved to a separate repo, click here

The changelog can be found here, The changelog for versions prior to v0.2.7 can be found here

External dependencies

Binaries for Windows and MacOS are included. Linux distributions need to manually install MediaInfo. MediaInfo is optional, but highly recommended since it increases the number of supported formats for video metadata extraction. Basic MKV metadata is supported when MediaInfo is not installed.