1Metadata-Version: 2.1
2Name: subliminal
3Version: 2.1.0
4Summary: Subtitles, faster than your thoughts
5Home-page: https://github.com/Diaoul/subliminal
6Author: Antoine Bertin
7Author-email: diaoulael@gmail.com
8License: MIT
9Description: Subliminal
10        ==========
11        Subtitles, faster than your thoughts.
12
13        .. image:: https://img.shields.io/pypi/v/subliminal.svg
14            :target: https://pypi.python.org/pypi/subliminal
15            :alt: Latest Version
16
17        .. image:: https://travis-ci.org/Diaoul/subliminal.svg?branch=develop
18            :target: https://travis-ci.org/Diaoul/subliminal
19            :alt: Travis CI build status
20
21        .. image:: https://readthedocs.org/projects/subliminal/badge/?version=latest
22            :target: https://subliminal.readthedocs.org/
23            :alt: Documentation Status
24
25        .. image:: https://coveralls.io/repos/Diaoul/subliminal/badge.svg?branch=develop&service=github
26            :target: https://coveralls.io/github/Diaoul/subliminal?branch=develop
27            :alt: Code coverage
28
29        .. image:: https://img.shields.io/github/license/Diaoul/subliminal.svg
30            :target: https://github.com/Diaoul/subliminal/blob/master/LICENSE
31            :alt: License
32
33        .. image:: https://img.shields.io/badge/gitter-join%20chat-1dce73.svg
34            :alt: Join the chat at https://gitter.im/Diaoul/subliminal
35            :target: https://gitter.im/Diaoul/subliminal
36
37
38        :Project page: https://github.com/Diaoul/subliminal
39        :Documentation: https://subliminal.readthedocs.org/
40
41
42        Usage
43        -----
44        CLI
45        ^^^
46        Download English subtitles::
47
48            $ subliminal download -l en The.Big.Bang.Theory.S05E18.HDTV.x264-LOL.mp4
49            Collecting videos  [####################################]  100%
50            1 video collected / 0 video ignored / 0 error
51            Downloading subtitles  [####################################]  100%
52            Downloaded 1 subtitle
53
54        Library
55        ^^^^^^^
56        Download best subtitles in French and English for videos less than two weeks old in a video folder:
57
58        .. code:: python
59
60            #!/usr/bin/env python
61
62            from datetime import timedelta
63
64            from babelfish import Language
65            from subliminal import download_best_subtitles, region, save_subtitles, scan_videos
66
67            # configure the cache
68            region.configure('dogpile.cache.dbm', arguments={'filename': 'cachefile.dbm'})
69
70            # scan for videos newer than 2 weeks and their existing subtitles in a folder
71            videos = scan_videos('/video/folder', age=timedelta(weeks=2))
72
73            # download best subtitles
74            subtitles = download_best_subtitles(videos, {Language('eng'), Language('fra')})
75
76            # save them to disk, next to the video
77            for v in videos:
78                save_subtitles(v, subtitles[v])
79
80        Docker
81        ^^^^^^
82        Run subliminal in a docker container::
83
84            $ docker run --rm --name subliminal -v subliminal_cache:/usr/src/cache -v /tvshows:/tvshows -it diaoulael/subliminal download -l en /tvshows/The.Big.Bang.Theory.S05E18.HDTV.x264-LOL.mp4
85
86        Installation
87        ------------
88        Subliminal can be installed as a regular python module by running::
89
90            $ [sudo] pip install subliminal
91
92        For a better isolation with your system you should use a dedicated virtualenv or install for your user only using
93        the ``--user`` flag.
94
95        Nautilus/Nemo integration
96        -------------------------
97        See the dedicated `project page <https://github.com/Diaoul/nautilus-subliminal>`_ for more information.
98
99
100        Changelog
101        ---------
102
103        2.1.0
104        ^^^^^
105        **release date:** 2020-05-02
106
107        * Improve legendastv provider matches
108        * Fix video extensions (.mk3d .ogm .ogv)
109        * Use new url to search for titles in legendastv provider
110        * Fix stevedore incompatibility
111        * Add support to webm video extension
112        * Make providers easier to be extended and customized
113        * Update podnapisi URL
114        * Add support to VIP/Donor accounts in legendastv provider
115        * Proper handling titles with year / country in legendastv provider
116        * Several minor enhancements in legendastv provider
117        * Add support for python 3.6, 3.7 and 3.8
118        * Drop support for python 3.3 and 3.4
119        * Do not discard providers bad zip/rar is downloaded
120        * SubsCenter provider removal
121        * Fix lxml parsing for Addic7ed provider
122        * Support titles with asterics in Addic7ed provider
123        * Add support to multi-episode search in Opensubtitles provider
124        * Fix multi-episode search in TVSubtitles provider
125        * Update to guessit 3
126        * Improve archive scanning
127        * Add Opensubtitles VIP provider
128        * Add country to Movie and Episode
129        * Add streaming_service to Video
130        * Add info property to Subtitle
131        * Do not search for subtitles if all required languages is already present
132        * Improve TVDB refiner to support series with comma
133        * Add alternative_titles to Video and enhance OMDB refiner to use alternative_titles
134        * Only compute video hashes when required
135        * Add apikey to OMDB refiner
136        * Fix Subtitle validation when unable to guess encoding
137        * Add support to rar in Dockerfile
138
139
140        2.0.5
141        ^^^^^
142        **release date:** 2016-09-03
143
144        * Fix addic7ed provider for some series name
145        * Fix existing subtitles detection
146        * Improve scoring
147        * Add Docker container
148        * Add .ogv video extension
149
150
151        2.0.4
152        ^^^^^
153        **release date:** 2016-09-03
154
155        * Fix subscenter
156
157
158        2.0.3
159        ^^^^^
160        **release date:** 2016-06-10
161
162        * Fix clearing cache in CLI
163
164
165        2.0.2
166        ^^^^^
167        **release date:** 2016-06-06
168
169        * Fix for dogpile.cache>=0.6.0
170        * Fix missing sphinx_rtd_theme dependency
171
172
173        2.0.1
174        ^^^^^
175        **release date:** 2016-06-06
176
177        * Fix beautifulsoup4 minimal requirement
178
179
180        2.0.0
181        ^^^^^
182        **release date:** 2016-06-04
183
184        * Add refiners to enrich videos with information from metadata, tvdb and omdb
185        * Add asynchronous provider search for faster searches
186        * Add registrable managers so subliminal can run without install
187        * Add archive support
188        * Add the ability to customize scoring logic
189        * Add an age argument to scan_videos for faster scanning
190        * Add legendas.tv provider
191        * Add shooter.cn provider
192        * Improve matching and scoring
193        * Improve documentation
194        * Split nautilus integration into its own project
195
196
197        1.1.1
198        ^^^^^
199        **release date:** 2016-01-03
200
201        * Fix scanning videos on bad MKV files
202
203
204        1.1
205        ^^^
206        **release date:** 2015-12-29
207
208        * Fix library usage example in README
209        * Fix for series name with special characters in addic7ed provider
210        * Fix id property in thesubdb provider
211        * Improve matching on titles
212        * Add support for nautilus context menu with translations
213        * Add support for searching subtitles in a separate directory
214        * Add subscenter provider
215        * Add support for python 3.5
216
217
218        1.0.1
219        ^^^^^
220        **release date:** 2015-07-23
221
222        * Fix unicode issues in CLI (python 2 only)
223        * Fix score scaling in CLI (python 2 only)
224        * Improve error handling in CLI
225        * Color collect report in CLI
226
227
228        1.0
229        ^^^
230        **release date:** 2015-07-22
231
232        * Many changes and fixes
233        * New test suite
234        * New documentation
235        * New CLI
236        * Added support for SubsCenter
237
238
239        0.7.5
240        ^^^^^
241        **release date:** 2015-03-04
242
243        * Update requirements
244        * Remove BierDopje provider
245        * Add pre-guessed video optional argument in scan_video
246        * Improve hearing impaired support
247        * Fix TVSubtitles and Podnapisi providers
248
249
250        0.7.4
251        ^^^^^
252        **release date:** 2014-01-27
253
254        * Fix requirements for guessit and babelfish
255
256
257        0.7.3
258        ^^^^^
259        **release date:** 2013-11-22
260
261        * Fix windows compatibility
262        * Improve subtitle validation
263        * Improve embedded subtitle languages detection
264        * Improve unittests
265
266
267        0.7.2
268        ^^^^^
269        **release date:** 2013-11-10
270
271        * Fix TVSubtitles for ambiguous series
272        * Add a CACHE_VERSION to force cache reloading on version change
273        * Set CLI default cache expiration time to 30 days
274        * Add podnapisi provider
275        * Support script for languages e.g. Latn, Cyrl
276        * Improve logging levels
277        * Fix subtitle validation in some rare cases
278
279
280        0.7.1
281        ^^^^^
282        **release date:** 2013-11-06
283
284        * Improve CLI
285        * Add login support for Addic7ed
286        * Remove lxml dependency
287        * Many fixes
288
289
290        0.7.0
291        ^^^^^
292        **release date:** 2013-10-29
293
294        **WARNING:** Complete rewrite of subliminal with backward incompatible changes
295
296        * Use enzyme to parse metadata of videos
297        * Use babelfish to handle languages
298        * Use dogpile.cache for caching
299        * Use charade to detect subtitle encoding
300        * Use pysrt for subtitle validation
301        * Use entry points for subtitle providers
302        * New subtitle score computation
303        * Hearing impaired subtitles support
304        * Drop async support
305        * Drop a few providers
306        * And much more...
307
308
309        0.6.4
310        ^^^^^
311        **release date:** 2013-05-19
312
313        * Fix requirements due to enzyme 0.3
314
315
316        0.6.3
317        ^^^^^
318        **release date:** 2013-01-17
319
320        * Fix requirements due to requests 1.0
321
322
323        0.6.2
324        ^^^^^
325        **release date:** 2012-09-15
326
327        * Fix BierDopje
328        * Fix Addic7ed
329        * Fix SubsWiki
330        * Fix missing enzyme import
331        * Add Catalan and Galician languages to Addic7ed
332        * Add possible services in help message of the CLI
333        * Allow existing filenames to be passed without the ./ prefix
334
335
336        0.6.1
337        ^^^^^
338        **release date:** 2012-06-24
339
340        * Fix subtitle release name in BierDopje
341        * Fix subtitles being downloaded multiple times
342        * Add Chinese support to TvSubtitles
343        * Fix encoding issues
344        * Fix single download subtitles without the force option
345        * Add Spanish (Latin America) exception to Addic7ed
346        * Fix group_by_video when a list entry has None as subtitles
347        * Add support for Galician language in Subtitulos
348        * Add an integrity check after subtitles download for Addic7ed
349        * Add error handling for if not strict in Language
350        * Fix TheSubDB hash method to return None if the file is too small
351        * Fix guessit.Language in Video.scan
352        * Fix language detection of subtitles
353
354
355        0.6.0
356        ^^^^^
357        **release date:** 2012-06-16
358
359        **WARNING:** Backward incompatible changes
360
361        * Fix --workers option in CLI
362        * Use a dedicated module for languages
363        * Use beautifulsoup4
364        * Improve return types
365        * Add scan_filter option
366        * Add --age option in CLI
367        * Add TvSubtitles service
368        * Add Addic7ed service
369
370
371        0.5.1
372        ^^^^^
373        **release date:** 2012-03-25
374
375        * Improve error handling of enzyme parsing
376
377
378        0.5
379        ^^^
380        **release date:** 2012-03-25
381        **WARNING:** Backward incompatible changes
382
383        * Use more unicode
384        * New list_subtitles and download_subtitles methods
385        * New Pool object for asynchronous work
386        * Improve sort algorithm
387        * Better error handling
388        * Make sorting customizable
389        * Remove class Subliminal
390        * Remove permissions handling
391
392
393        0.4
394        ^^^
395        **release date:** 2011-11-11
396
397        * Many fixes
398        * Better error handling
399
400
401        0.3
402        ^^^
403        **release date:** 2011-08-18
404
405        * Fix a bug when series is not guessed by guessit
406        * Fix dependencies failure when installing package
407        * Fix encoding issues with logging
408        * Add a script to ease subtitles download
409        * Add possibility to choose mode of created files
410        * Add more checks before adjusting permissions
411
412
413        0.2
414        ^^^
415        **release date:** 2011-07-11
416
417        * Fix plugin configuration
418        * Fix some encoding issues
419        * Remove extra logging
420
421
422        0.1
423        ^^^
424        **release date:** *private release*
425
426        * Initial release
427
428Keywords: subtitle subtitles video movie episode tv show series
429Platform: UNKNOWN
430Classifier: Development Status :: 5 - Production/Stable
431Classifier: Intended Audience :: Developers
432Classifier: License :: OSI Approved :: MIT License
433Classifier: Operating System :: OS Independent
434Classifier: Programming Language :: Python
435Classifier: Programming Language :: Python :: 2
436Classifier: Programming Language :: Python :: 2.7
437Classifier: Programming Language :: Python :: 3
438Classifier: Programming Language :: Python :: 3.5
439Classifier: Programming Language :: Python :: 3.6
440Classifier: Programming Language :: Python :: 3.7
441Classifier: Programming Language :: Python :: 3.8
442Classifier: Topic :: Software Development :: Libraries :: Python Modules
443Classifier: Topic :: Multimedia :: Video
444Provides-Extra: dev
445Provides-Extra: test
446