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.
Switch branches/tags
Clone or download
Permalink
Failed to load latest commit information.
.build Bower => Webpack (#4871) Aug 10, 2018
.docker/root/etc Integrate Dockerfile for easier builds (#3339) Nov 30, 2017
.github Revert changes to check_version.py Sep 6, 2018
dredd Update `/series` API to only get AniDB data if requested (#5166) Sep 9, 2018
ext Fix unable to start Medusa due to configparser ImportError (#5145) Sep 9, 2018
lib Feature/upgrade adba to medusa adba (#4822) Aug 18, 2018
medusa Fix TorrentLeech pagination code (#5172) Sep 9, 2018
runscripts Fix: Start medusa service after network.target (#3816) Feb 28, 2018
tests Fix HDSpace pubdate parsing (#5111) Sep 4, 2018
themes-default Post Processing config saving `select-list` values incorrectly (#5165) Sep 9, 2018
themes Post Processing config saving `select-list` values incorrectly (#5165) Sep 9, 2018
.codebeatignore add themes and themes-default to codebeat ignore (#3966) Apr 6, 2018
.codecov.yml Enable codecov flags (#4654) Jul 13, 2018
.dockerignore Integrate Dockerfile for easier builds (#3339) Nov 30, 2017
.editorconfig Add base vue files (#2699) May 18, 2017
.eslintignore Added eslint-config xo and eslint, to be used with ide's that support… Jan 19, 2018
.eslintrc Added eslint-config xo and eslint, to be used with ide's that support… Jan 19, 2018
.gitattributes Update meta (#5116) Sep 5, 2018
.gitignore Fix bower (#4472) Jun 27, 2018
.travis.yml Move stylelint from root to themes-default/slim (#5082) Aug 30, 2018
.yarnrc Update vue-loader & enable Webpack builds on Travis (#4878) Aug 21, 2018
CHANGELOG.md Fix TorrentLeech pagination code (#5172) Sep 9, 2018
CONTRIBUTING.md Update logging style (2). Replaces #2801 (#2809) May 19, 2017
COPYING.txt Update copyright license to the original author's license (#2976) Jul 18, 2017
Dockerfile Rev alpine linux to 3.7 after testing (#3561) Jan 5, 2018
SickBeard.py Add dedicated Torznab (Jackett) providers support (#3513) Apr 4, 2018
package.json Move stylelint from root to themes-default/slim (#5082) Aug 30, 2018
readme.md Update meta (#5116) Sep 5, 2018
renovate.json Remove babel group from renovate.json (#4986) Aug 29, 2018
requirements.txt Update dependency certifi to v2018.8.24 (#4952) Aug 24, 2018
setup.cfg Convert Post Processing Config to VueRouter (#4946) Sep 5, 2018
setup.py configured minimal versions. (#4873) Aug 7, 2018
start.py Add dedicated Torznab (Jackett) providers support (#3513) Apr 4, 2018
tox.ini Enable codecov flags (#4654) Jul 13, 2018
yarn.lock Move stylelint from root to themes-default/slim (#5082) Aug 30, 2018

readme.md

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)
  • 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 Python 2.7.10

Feature Requests

Medusa Issue Tracker
FAQ
Wiki

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 full list can be found here. Jackett is supported, however it must be configured as follows.

Special Thanks to:

RARBG RARBG  ·  NZB.cat NZB.cat  ·  NZBGeek NZBGeek  ·  DOGnzb DOGnzb  ·  DanishBits DanishBits

Browsers support made by godban

IE / Edge
IE / Edge
Firefox
Firefox
Chrome
Chrome
Safari
Safari
Edge last 2 versions last 2 versions last 2 versions

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

This product uses MediaInfo library, Copyright (c) 2002-2016 MediaArea.net 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.

Docker images

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

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