Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/h3llrais3r/Auto-Subliminal
Auto-Subliminal, the automated subliminal subtitle downloader
https://github.com/h3llrais3r/Auto-Subliminal
automated downloader movies shows subliminal subtitle
Last synced: 16 days ago
JSON representation
Auto-Subliminal, the automated subliminal subtitle downloader
- Host: GitHub
- URL: https://github.com/h3llrais3r/Auto-Subliminal
- Owner: h3llrais3r
- License: gpl-3.0
- Created: 2013-12-18T19:59:05.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2024-05-22T21:45:52.000Z (6 months ago)
- Last Synced: 2024-05-22T22:22:05.526Z (6 months ago)
- Topics: automated, downloader, movies, shows, subliminal, subtitle
- Language: CSS
- Homepage: https://h3llrais3r.github.io/Auto-Subliminal/
- Size: 155 MB
- Stars: 41
- Watchers: 7
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.html
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Auto-Subliminal [](https://github.com/h3llrais3r/Auto-Subliminal/blob/master/LICENSE) [](http://isitmaintained.com/project/h3llrais3r/Auto-Subliminal "Percentage of issues still open") [](http://isitmaintained.com/project/h3llrais3r/Auto-Subliminal "Average time to resolve an issue")
| Status | Master | Development |
| -------- | -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| CI | [](https://github.com/h3llrais3r/Auto-Subliminal/actions/workflows/ci.yaml?query=branch:master) | [](https://github.com/h3llrais3r/Auto-Subliminal/actions/workflows/ci.yaml?query=branch:development) |
| Coverage | [](https://coveralls.io/github/h3llrais3r/Auto-Subliminal?branch=master) | [](https://coveralls.io/github/h3llrais3r/Auto-Subliminal?branch=development) |
## 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](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!