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.

Information and Overview

If you do not use Rclone or Cloud Storage Please disregard the following warning.

Please make yourself aware of the Ultra.cc Fair Usage Policy. Directly pointing any Media Managment to download directly to on your cloud storage using Rclone Mount will create extreme strain on your slot's disk and WILL cause a 24 hour ban on accessing your cloud storage repeatedly. You MUST use the MergerFS mounting service documented in the Rclone Section. It is your responsibility to ensure usage is within acceptable limits. Ignorance is not an excuse.

Medusa is an open-sourced fully-automated PVR written in Python. It enables you to download your favorite TV shows, then processes and stores them in your library, all with minimal user intervention. Some of the featuresĀ are the following:

For more information, you can visit their site or their GitHub repo.

Initial Setup

Medusa is an open-sourced, fully automated PVR written in Python. It enables you to download your favorite TV shows, processes and stores them in your library, all with minimal user intervention. Some of the features are the following:

For more information, you can visit their site or their GitHub repo.

Initial Setup

In this guide, we'll be setting up Medusa for the first time. This guide assumes that this is your first time installing Medusa, and you'll be storing your media locally, saving it to ~/media/TV Shows.

We will be doing the following:

  1. Add root folder
  2. Connecting your download clients and setting their completed download directories for Medusa Post-Processing
  3. Adding indexers/search providers
  4. Configure Post-Processing
  5. Adding your first series

Add Root Folder

Adding Download Clients and Setting Post-Processing Directories

For download client setup settings, you may refer below

Torrent Clients

rTorrent
Connection Settings
Search .torrent files: ENABLED
Send .torrent files to: rtorrent
rTorrent host:port: https://{username}.{servername}.usbx.me/rutorrent/plugins/httprpc/action.php
Http Authentication: Basic
rTorrent Username: {username}
rTorrent Password: As configured in UCP under ruTorrent
Add Label To Torrent: Medusa
Downloaded Files Location: <EMPTY>
Post-Processing Setup

:::info This step is crucial if using ruTorrent as your download client. ruTorrent will not append an extension to downloads; therefore, Medusa's Post-Processor will import incomplete downloads if the Autotools-AutoMove plugin is not used in ruTorrent. :::

Transmission
Connection Settings
Search .torrent files: ENABLED
Send .torrent files to Transmission
Transmission host:port: https://{username}.{servername}.usbx.me
Transmission RPC URL: transmission/rpc
Transmission Username: {username}
Transmission Password: As configured in UCP under Transmission
Downloaded Files Location: EMPTY
Post Processing Setup

Transmission appends ".part" to the downloading file extensions until the download is completed, and Medusa will ignore these files with ".part" extensions, so there is no need to configure any further Post Processing directory settings for this client

Usenet Clients

NZBGet
Connection Settings
Search NZBs: ENABLED
Send .nzb files to: NZBGet
Host: {username}.{servername}.usbx.me/nzbget
Connect using HTTPS: ENABLED
Username: {nzbget username}
Password: {nzbget password}
Use NZBget category: Medusa
Use NZBget category (backlog episodes): Medusa
Use NZBget category for anime: Medusa-Anime
Use NZBget category for anime (backlog episodes): Medusa-Anime
Post-Processing Setup

Per the example in the screenshot below, {HOME##} is home8 and the {username} is docs, so the full path for the files directory would be: /home8/docs/files

SABnzbd
Connection Settings
Search NZBs: ENABLED
Send .nzb files to: SABnzbd
Host: {username}.{servername}.usbx.me/sabnzbd/
Username: {sabznbd username}
Password: {sabnzbd password}
SABnzbd : {sabnzbd api key}
Use SABnzbd category: Medusa
Use SABnzbd category (backlog episodes): Medusa
Use SABnzbd category for anime: Medusa-Anime
Use SABnzbd category for anime (backlog episodes): Medusa-Anime

**It is vital to have the trailing / on the end of your SABnzbd host. Otherwise, Medusa will fail to add NZBs successfully to this client.

Post-Processing Setup

Add Search Providers/Indexers

Post-Processing Settings

::: info It's essential to be sure only your COMPLETED downloads are in this location. Otherwise, Medusa's Post-Processor may import incomplete media and cause errors. You may refer to the Medusa Download Client Connection Details to set completed directories for your download clients to this location :::

If your torrent trackers have archives, it would be recommended to enable Medusa's Unpack feature:


Adding Your First Series

Extra Guides(MEDUSA)

Extra Guides(MEDUSA)

Download Client Connection Details

Torrent Clients

rTorrent

Connection Settings

Search .torrent files: ENABLED
Send .torrent files to: rtorrent
rTorrent host:port: https://{username}.{servername}.usbx.me/rutorrent/plugins/httprpc/action.php
Http Authentication: Basic
rTorrent Username: {username}
rTorrent Password: As configured in UCP under ruTorrent
Add Label To Torrent: Medusa
Downloaded Files Location: <EMPTY>

Post-Processing Setup

This step is very important if using ruTorrent as your download client. ruTorrent will not append an extension to downloads therefore Medusa's Post-Processor will import incomplete downloads if the Auotools-AutoMove plugin is not used in ruTorrent.

Transmission

Connection Settings

Search .torrent files: ENABLED
Send .torrent files to: Transmission 
Transmission host:port: https://{username}.{servername}.usbx.me
Transmission RPC URL: transmission/rpc
Transmission Username: {username}
Transmission Password: As configured in UCP under Transmission
Downloaded Files Location: EMPTY

Post Processing Setup

Transmission appends ".part" to the downloading file extensions until the download is completed and Medusa will ignore these files with ".part" extensions, so there is no need to configure any further Post Processing directory settings for this client

Usenet Clients

NZBGet: Connection Settings

Search NZBs: ENABLED
Send .nzb files to: NZBGet
Host: {username}.{servername}.usbx.me/nzbget
Connect using HTTPS: ENABLED
Username: {nzbget username}
Password: {nzbget password}
Use NZBget category: Medusa
Use NZBget category (backlog episodes): Medusa
Use NZBget category for anime: Medusa-Anime
Use NZBget category for anime (backlog episodes): Medusa-Anime

NZBGet: Post Processing Setup