Ubuntu users, please use the repository so that updates will be pushed to you.
Presentationperiscope is a subtitles searching module written in python that tries to find a correct match for a given video file. The goal behind periscope is that it will only return only correct subtitles so that you can simply relax and enjoy your video without having to double-check that the subtitles match your video before watching it.
This is done by using as much info as available from your file and on the websites. Some websites allow you to use hash of the files, the size/length of the video or the exact file name.
As a python module, periscope should be easily integrated in many projects that allow plugins to be written in python. The fact that the plugin is shared between all the applications means that separate application and their plugin (file browser, video player, media center application, ...) don't have to maintain the code to search, parse and download subtitles and the user preference about languages.
The subtitles websites are handled as plugins and currently support :
OpenSubtitles.org SubtitleSource.org Podnapisi.net Subscene.com Subtitulos.es
InstallationUbuntuFor Ubuntu users, you can add the repository for periscope in Synaptic. All information are located on the Wiki: http://code.google.com/p/periscope/wiki/UbuntuRepository
DebianI believe the Ubuntu package should be installable on Debian unstable.
From source codeYou can checkout the code. The setup.py is included in SVN.
UsageYou can use the module with a CLI by doing
$ periscope -l en
$ periscope -l en -l frto search subtitles in english, replace 'en' by 'fr', 'de' or whatever language you would like your subtitles in. Note : Brazilian Portuguese is written as "pt-br", Argentinian Spanish is written as "es-ar".
You can also use periscope in Nautilus by following the instructions on the wiki page
RequirementsAs of version 0.1.7
You will need Python (>= 2.6, < 3.0) to run periscope. You will also need the python module beautifulsoup to parse html pages. An executable unrar command could be needed for some plugins
Screenshot(s)Nautilus IntegrationA Nautilus plugin exists to integrate periscope in Nautilus:
Changes0.1.8.1 * Fixes the language from the config file
* Fixes Podnapisi support
* Various bugfixes0.1.7 * support for subscene.com and subtitulos.es
* CLI shows a report at the end0.1.6 * bugfixes0.1.5 * use queues to query the websites so that the queries run in parallel
* updated code for podnapisi
* updated code for OpenSubtitles.org
* package for persicope-gnome (currently only right-click in Nautilus)0.1.4 * use freedesktop.org config system to choose the language
* use the API for SubtitleSource.org
Copyright © 2013 Black Duck Software, Inc. and its contributors, Some Rights Reserved. Unless otherwise marked, this work is licensed under a Creative Commons Attribution 3.0 Unported License . Ohloh ® and the Ohloh logo are trademarks of Black Duck Software, Inc. in the United States and/or other jurisdictions. All other trademarks are the property of their respective holders.