Ubuntu users, please use the repository so that updates will be pushed to you.
Presentation
periscope 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 :
Installation
Ubuntu
For 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
Debian
I believe the Ubuntu package should be installable on Debian unstable.
From source code
You can checkout the code. The setup.py is included in SVN.
Usage
You can use the module with a CLI by doing
$ periscope </path/to/my/video> -l en $ periscope </path/to/my/vidoe> -l en -l fr
to search subtitles in english, replace 'en' by 'fr', 'de' or whatever language you would like your subtitles in.
You can also use periscope in Nautilus by following the instructions on the wiki page
Requirements
- You will need Python (>= 2.4, < 3.0) to run periscope.
- You will also need the python module beautifulsoup to parse html pages.
Screenshot(s)
Nautilus Integration
A Nautilus plugin exists to integrate periscope in Nautilus:
Changes
0.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
