Auto-Subliminal License Percentage of issues still open Average time to resolve an issue

Status Master Development
CI CI Status CI Status
Coverage Coverage Status Coverage Status
Requirements Requirements Status Requirements Status


Welcome to Auto-Subliminal, the automated python subtitle downloader!

This is a modified version of the discontinued Auto-Sub Alpha 0.5.8 project ( It makes use of Subliminal ( for checking and downloading subtitles.

What it does

  • Easy and straightforward script that scans your TV and MOVIE contents
  • If no SUBTITLE is found (externally or internally) it will attempt to download one by using Subliminal
  • Subliminal will attempt to match the correct version of the subtitle with the file located on the disk
  • Once every day it will do a full rescan of your local content
  • Support to search/save/delete a subtitle individually
  • Support to play a video remotely (need to register a custom protocol handler on your remote machine)


  • To run Auto-Subliminal from source you need Python 3.6 or higher
  • Packaged external libraries: see libaries.txt

How to use

  • Install python
  • On Windows: Install pywin32
  • Start the script: " python "
  • A web browser should now open
  • Go to the config menu, check the settings and make sure you set at least:
    • Video paths: The root folder(s) of your series and/or movies
    • Default language: Your primary subtitle language
    • Subliminal settings: Your minimal match score and used providers
  • Restart Auto-Subliminal

Enjoy your subtitles!

Auto Subliminal

Auto-Subliminal, the automated subliminal subtitle downloader

Auto Subliminal Info

⭐ Stars 39
🔗 Homepage
🔗 Source Code
🕒 Last Update 8 months ago
🕒 Created 9 years ago
🐞 Open Issues 7
➗ Star-Issue Ratio 6
😎 Author h3llrais3r