Help the development of periscope by making a donation using paypal.

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 :

• OpenSubtitles.org
• SubtitleSource.org
• Subscene.com
• Subtitulos.es
• Addic7ed.com
• TheSubDB.com
• BierDopje.com

---

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. 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

Requirements

As 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 Integration

A Nautilus plugin exists to integrate periscope in Nautilus:

Changes

0.1.9

Better error handling
Removing Podnapisi.net (temporary)
Added Addic7ed.com
Experimental support for TVSubtitles.net (not activated by default)

0.1.8.1

 * Fixes the language from the config file
 * Fixes Podnapisi support
 * Various bugfixes

0.1.7

 * support for subscene.com and subtitulos.es
 * CLI shows a report at the end