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:
OpenSubtitles
TheSubDB
BierDopje
SubsWiki
Subtitulos
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 subtitles (Episode(u'The.Big.Bang.Theory.S05E18.HDTV.x264-LOL.mp4'), ResultSubtitle(en, opensubtitles, 0.33, The.Big.Bang.Theory.S05E18.HDTV-LOL.srt)) **************************************************
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.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.