Skip to main content


(py)Medusa is an automatic video library manager for TV Shows written in Python. It watches for new episodes of your favorite shows, and when they are posted it does its magic.

Initial Setup#

First you must connect to your slot via ssh. If you need help connecting to the server, please read the help article here.

Installing Medusa is easy. Simply issue the following command:

box install medusa

This command will configure medusa for your user.

How to Access#

After installation, you can access Medusa at the url: https://<>/medusa

Service Management#

Like all box configured applications, you can manage Medusa via SSH with box with start, stop, restart, enable and disable commands.

box start medusa


If you are unfamiliar with Medusa, please check out their wiki for assistance in getting your trackers setup or learning how to add shows or setup post-processing.

Connect to other clients#

Send torrent files to: rTorrent
rTorrent host/port:
Http Authentication: Basic
Verify certificate: off (shouldn't need to be turned on)
rTorrent username: <your username>
rTorrent password: <your password>
Add label to torrent: TV (or anything else you desire)
Downloaded files location: ~/torrents/rtorrent (or a custom directory)