Skip to content
A multiplatform (should work on Windows, Linux and Mac) client written in Python for SubDB
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


SubDB - a free subtitle database


Pyrrot is a multiplatform client for SubDB written in Python. It can run on Windows, Linux and MacOS.


  • Python 2.6.5 for all systems.
  • Mark Hammond's Win32all if you want to run Pyrrot as a service on Windows.


You need to copy and to a folder of your preference. Then, after you've done with the configurations (see below), all you need to do is:

python or c:\Python2.6.5\python.exe c:\path\to\ (if you're using windows)

You can also run Pyrrot using cron, or install Pyrrot as a Windows service. To do this:

Cron (Linux): */30 * * * * python /path/to/

Service (Windows): c:\Python2.6.5\python.exe c:\path\to\ --startup auto install

As you may have noticed, you need to copy too.


You need to edit the following lines on before use it:

PYRROT_DIR = "/path/to/pyrrot" #The path to where Pyrrot is. Can be empty if you're not running Pyrrot as a Windows Service.

DIRECTORIES = ["/path/to/your/video/files", "/path/to/your/video/files2"] #Configure here the directories where your video files are.

LANGUAGES = ["pt", "en"] #The languages to download subtitles, in order of preference.

MOVIE_EXTS = ['.avi', '.mkv', '.mp4', '.mov', '.mpg', '.wmv'] #The video file extensions that you want Pyrrot to looking for.

SUBS_EXTS = ['.srt', '.sub'] #The subtitle extensions that you want Pyrrot to looking for.

If you are on Windows, the paths will be like:

PYRROT_DIR = "c:\\path\\to\\pyrrot"



This software is distribute under Creative Commons Attribution-Noncommercial-Share Alike 3.0. You can read the entire license on:

You can’t perform that action at this time.