Need help with Medusa?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

1.3K Stars 218 Forks GNU General Public License v3.0 16.4K Commits 160 Opened issues


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.

Services available


Need anything else?

Contributors list

Average time to resolve an issue Percentage of issues still open
codebeat badge XO code style codecov

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 and 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


To run Medusa from source you will need one of these Python versions: * Python 3 – 3.6.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 team have kindly produced docker images for X86, armhf and aarch64 platforms. This is built from an older intermediary Dockerfile.

Feature Requests

Medusa Issue Tracker


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:

RARBG RARBG  ·  ·  NZBGeek NZBGeek  ·  DOGnzb DOGnzb  ·  DanishBits DanishBits

Browsers support made by godban

| IE / EdgeIE / Edge | FirefoxFirefox | ChromeChrome | SafariSafari | | --------- | --------- | --------- | --------- | | Edge| last 2 versions| last 2 versions| last 2 versions

News and Changelog 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

This product uses MediaInfo library, Copyright (c) 2002-2016 SARL

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.