Skip to content
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.
Branch: master
Clone or download
Latest commit 94fae84 Mar 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.build
.docker/root/etc Integrate Dockerfile for easier builds (#3339) Nov 30, 2017
.github
dredd Vueify show header (#6189) Feb 17, 2019
ext Update Python dependency certifi to v2019 (#6290) Mar 12, 2019
ext2 Update Python dependency configparser to v3.7.3 (#6242) Mar 12, 2019
ext3
lib Replace synchronousdeluge with deluge-client. Fixes #6278 (#6279) Mar 6, 2019
medusa Yarn build Mar 13, 2019
runscripts Default systemd to Type=simple (#6264) Mar 2, 2019
tests Replace synchronousdeluge with deluge-client. Fixes #6278 (#6279) Mar 6, 2019
themes-default Update JS jest monorepo to v24.5.0 (#6321) Mar 12, 2019
themes
.codebeatignore
.codecov.yml CI: Test on Python 3.6 (#5136) Nov 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 Update JS vue-base (#6162) Mar 11, 2019
.gitattributes
.gitignore Update vendored lib & list: urllib3 [1.23 -> 1.24.1] (#5945) Dec 31, 2018
.travis.yml [Python3] Several changes to migrate the code to python3 (part 3) (#4982 Dec 22, 2018
.yarnrc
CHANGELOG.md Update CHANGELOG.md Mar 13, 2019
CONTRIBUTING.md
COPYING.txt Update copyright license to the original author's license (#2976) Jul 18, 2017
Dockerfile
SickBeard.py Store the python version on startup in config (#5892) Dec 17, 2018
package.json
readme.md Update Python 3 information (#6035) Jan 18, 2019
renovate.json Update JS dependency vue-js-toggle-button to v1.3.2 (#6244) Mar 12, 2019
requirements.txt
setup.cfg
setup.py Generic provider maintenance (#6217) Feb 22, 2019
start.py
tox.ini Generic provider maintenance (#6217) Feb 22, 2019
yarn.lock Update JS dependency dredd to v8.0.5 (#6317) Mar 12, 2019

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)
  • 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 2 – 2.7.10 and above
  • Python 3 – 3.5.0 and above

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.

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.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.