Subtitles, faster than your thoughts
Project description
Subliminal
Subliminal is a python library to search and download subtitles.
It uses video hashes and the powerful guessit library that extracts informations from filenames or filepaths to ensure you have the best subtitles. It also relies on enzyme to detect embedded subtitles and avoid duplicates.
Features
Multiple subtitles services are available:
Addic7ed
BierDopje
OpenSubtitles
SubsWiki
Subtitulos
TheSubDB
TvSubtitles
You can use main subliminal’s functions with a file path, a file name or a folder path.
CLI
Download english subtitles:
$ subliminal -l en The.Big.Bang.Theory.S05E18.HDTV.x264-LOL.mp4 ************************************************** Downloaded 1 subtitle(s) for 1 video(s) The.Big.Bang.Theory.S05E18.HDTV.x264-LOL.srt from opensubtitles **************************************************
Module
List english subtitles:
>>> subliminal.list_subtitles('The.Big.Bang.Theory.S05E18.HDTV.x264-LOL.mp4', ['en'])
Multi-threaded use
Use 4 workers to achieve the same result:
>>> with subliminal.Pool(4) as p: ... p.list_subtitles('The.Big.Bang.Theory.S05E18.HDTV.x264-LOL.mp4', ['en'])
News
0.6.4
release date: 2013-05-19
Fix requirements due to enzyme 0.3
0.6.3
release date: 2013-01-17
Fix requirements due to requests 1.0
0.6.2
release date: 2012-09-15
Fix BierDopje
Fix Addic7ed
Fix SubsWiki
Fix missing enzyme import
Add Catalan and Galician languages to Addic7ed
Add possible services in help message of the CLI
Allow existing filenames to be passed without the ./ prefix
0.6.1
release date: 2012-06-24
Fix subtitle release name in BierDopje
Fix subtitles being downloaded multiple times
Add Chinese support to TvSubtitles
Fix encoding issues
Fix single download subtitles without the force option
Add Spanish (Latin America) exception to Addic7ed
Fix group_by_video when a list entry has None as subtitles
Add support for Galician language in Subtitulos
Add an integrity check after subtitles download for Addic7ed
Add error handling for if not strict in Language
Fix TheSubDB hash method to return None if the file is too small
Fix guessit.Language in Video.scan
Fix language detection of subtitles
0.6.0
release date: 2012-06-16 WARNING: Backward incompatible changes
Fix –workers option in CLI
Use a dedicated module for languages
Use beautifulsoup4
Improve return types
Add scan_filter option
Add –age option in CLI
Add TvSubtitles service
Add Addic7ed service
0.5.1
release date: 2012-03-25
Improve error handling of enzyme parsing
0.5
release date: 2012-03-25 WARNING: Backward incompatible changes
Use more unicode
New list_subtitles and download_subtitles methods
New Pool object for asynchronous work
Improve sort algorithm
Better error handling
Make sorting customizable
Remove class Subliminal
Remove permissions handling
0.4
release date: 2011-11-11
Many fixes
Better error handling
0.3
release date: 2011-08-18
Fix a bug when series is not guessed by guessit
Fix dependencies failure when installing package
Fix encoding issues with logging
Add a script to ease subtitles download
Add possibility to choose mode of created files
Add more checks before adjusting permissions
0.2
release date: 2011-07-11
Fix plugin configuration
Fix some encoding issues
Remove extra logging
0.1
release date: not released yet
Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.