Skip to content

h3llrais3r/Auto-Subliminal

Repository files navigation

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

About

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

This is a modified version of the discontinued Auto-Sub Alpha 0.5.8 project (https://code.google.com/p/auto-sub/). It makes use of Subliminal (https://github.com/Diaoul/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)

Dependencies

  • To run Auto-Subliminal from source you need Python 3.8 or higher
  • Required dependencies: see requirements.txt

How to use

  • Install python
  • Create a virtual environment and activate it
  • Install all requirements in the virtual environment: pip install -r requirements.txt
  • Start the script: python AutoSubliminal.py
  • If you didn't create a virutal environment, the script creates one for you with the name .venv in the project root and will restart the script in the virtual environment
  • If you didn't install the requirements, the script will install them for you in the virtual environment
  • 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!