My favorites | Sign in
Project Logo
                
Show all Featured wiki pages:
UbuntuRepository
Feeds:
People details
Project owners:
  patrick.dessalle

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

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








Hosted by Google Code