Introduction

This wiki pages shows you the steps to add periscope support into Nautilus by simply doing a right-click "Download subtitles" on a video file.

This wiki reflects details for the latest version of the package

Ubuntu user

If you use Ubuntu, you may prefer to install the periscope-gnome package from the repository

Details

Install python support in nautilus by installing python-nautilus and python-notify that shows notification on the bottom-right of your screen:

For Ubuntu:

sudo aptitude install python-nautilus python-notify

Install periscope from the project home page: http://code.google.com/p/periscope/

Ubuntu/Debian users : Download the lastest debs (python-periscope and periscope-gnome) and double-click on it. That's it.

Copy the periscope-nautilus.py script into the ~/.nautilus/python-extensions

cd ~/.nautilus/python-extensions
wget http://periscope.googlecode.com/svn/trunk/bin/periscope-nautilus/periscope-nautilus.py

If you want to change the default languages, run periscope once, a file named "config" will be created under ~/.config/periscope. Update this file to reflect your prefered languages. They can be separated by comas, so:

lang = en 
or
lang = en,fr

are valid. The first one saying that you want to search subtitles in english, the second, in english and if not found, in french.

Restart nautilus otherwise it does not take into account the newly added scripts by typing in a terminal nautilus -q

Open nautilus and go to a location where you have video files. Right-click on a video and wait for the notification to see if a match was found.

Comment by inverniz...@gmail.com, May 6, 2009

awesome project

Comment by hemanth...@gmail.com, Jun 20, 2009

Compiling the source and executing from a python interpreter says , no such module nautilus , tough i have python-nautilus package. How to resolve this ?

Comment by war...@gmail.com, Dec 5, 2009

Just install periscope-gnome doesn't install the nautilus script. I have to do it myself. It is normal?

Comment by project member patrick....@gmail.com, Aug 17, 2010

@warflo periscope-gnome does not install the script in you home directory but at the system level. After a restart of nautilus (you kan killall nautilus or restart your session), the right-click should appear

Comment by hdes...@gmail.com, Sep 15, 2010

Hey, how can I search for spanish subtitles ? I couldn't find any... I change the language to "es" in the config file. But nothing happened. I tryied with a couple of movies I have.

Comment by project member patrick....@gmail.com, Sep 16, 2010

@hdesoto It should work fine by just setting es as you did.

Most spanish subtitles come from subtitulos.es and it seem this website is mainly targeted at tv shows more than movies. If you have suggestions of good websites with spanish subtitles, you can always create an issue in the issue tab.

If you could send me an email to admin [at] getmesubs.com with the file names you've been searching on, I could run a test on my machine.

Comment by terminu...@gmail.com, Sep 24, 2010

I can't download any subtitle, I've tried in spanish, english and french.

terminus77@sobremesa:/media/Datos/eMule/Torrent$ periscope Avatar.avi -l en INFO:root:Searching subtitles for Avatar.avi with langs ['en'] INFO:root:Searching on OpenSubtitles? INFO:root:Searching on SubtitleSource? INFO:root:Searching on SubScene? INFO:root:Searching on Subtitulos INFO:root:Subtitulos writing 0 items to queue INFO:root:Searching on Addic7ed INFO:root:Addic7ed writing 0 items to queue INFO:root:Searching on Podnapisi ERROR:root:Error raised by plugin SubtitleSource?: no element found: line 1, column 0 Traceback (most recent call last):

File "/usr/lib/python2.6/dist-packages/periscope/plugins/SubtitleSource?.py", line 49, in process
subs = self.query(fname, langs)
File "/usr/lib/python2.6/dist-packages/periscope/plugins/SubtitleSource?.py", line 83, in query
xmltree = xml.dom.minidom.parse(page)
File "/usr/lib/python2.6/xml/dom/minidom.py", line 1918, in parse
return expatbuilder.parse(file)
File "/usr/lib/python2.6/xml/dom/expatbuilder.py", line 928, in parse
result = builder.parseFile(file)
File "/usr/lib/python2.6/xml/dom/expatbuilder.py", line 211, in parseFile
parser.Parse("", True)

ExpatError?: no element found: line 1, column 0 INFO:root:SubtitleSource? writing 0 items to queue ERROR:root:Error raised by plugin SubScene?: 'id' Traceback (most recent call last):

File "/usr/lib/python2.6/dist-packages/periscope/plugins/SubScene?.py", line 71, in process
subs = self.query(fname, langs)
File "/usr/lib/python2.6/dist-packages/periscope/plugins/SubScene?.py", line 166, in query
sub_id = subs["id"][1:]
File "/usr/lib/pymodules/python2.6/BeautifulSoup?.py", line 541, in getitem
return self.getAttrMap()key?

KeyError?: 'id' INFO:root:SubScene? writing 0 items to queue INFO:root:Podnapisi writing 0 items to queue INFO:root:OpenSubtitles? writing 0 items to queue INFO:root: INFO:root:Downloaded 0 subtitles INFO:root:

Comment by project member patrick....@gmail.com, Sep 25, 2010

Periscope is meant to search based on the release name, Avatar.avi is just too generic. If the file does not keep the original filename, the search is probably not going to be that effective. If the file was named, Avatar2009?DvDrip?Eng?-FXG.avi for instance, some results would have come up.

Comment by churchy...@gmail.com, Nov 19, 2010

You can also integrate periscope to Thunar (Xfce). See here (totoal bottom of the page) http://thunar.xfce.org/pwiki/documentation/custom_actions

Comment by andisthe...@gmail.com, Jun 7, 2011

Hey, just to report it...The gnome plugin will find no subs, but if I run it through terminal, subs will bw found and downloaded fine :)

Comment by lucaz...@hotmail.com, Feb 9, 2012

This is my problem:

mainstream@dopamine-pc:~/Downloads/FiNiSHED/TV-EPiSODES/asd$ periscope -f -l nl Family.Guy.S10E12?.720p.HDTV.X264-DIMENSION.mkv INFO:periscope.periscope:Searching subtitles for Family.Guy.S10E12?.720p.HDTV.X264-DIMENSION.mkv with langs ['nl'] INFO:periscope.periscope:Searching on OpenSubtitles? ERROR:periscope.plugins.SubtitleDatabase?:File is too small INFO:periscope.periscope:Searching on Subtitulos INFO:periscope.periscope:Searching on Podnapisi INFO:periscope.periscope:Searching on TheSubDB INFO:periscope.periscope:Searching on BierDopje? ERROR:periscope.plugins.SubtitleDatabase?:Error occured Traceback (most recent call last):

File "/usr/lib/python2.7/dist-packages/periscope/plugins/SubtitleDatabase?.py", line 45, in searchInThread
subs = self.process(filename, langs)
File "/usr/lib/python2.7/dist-packages/periscope/plugins/TheSubDB.py", line 55, in process
filehash = self.get_hash(filepath)
File "/usr/lib/python2.7/dist-packages/periscope/plugins/TheSubDB.py", line 91, in get_hash
f.seek(-readsize, os.SEEK_END)

IOError: 22? Invalid argument INFO:periscope.periscope:Searching on SubsWiki? INFO:periscope.plugins.SubtitleDatabase?:OpenSubtitles? writing 0 items to queue INFO:periscope.plugins.SubtitleDatabase?:Subtitulos writing 0 items to queue INFO:periscope.plugins.SubtitleDatabase?:SubsWiki? writing 0 items to queue INFO:periscope.plugins.SubtitleDatabase?:BierDopje? writing 0 items to queue INFO:periscope.plugins.SubtitleDatabase?:Podnapisi writing 0 items to queue INFO:main: INFO:main:Downloaded 0 subtitles INFO:main:

I checked and the file is on bierdopje.com, but it has problems?

Comment by naar...@gmail.com, Apr 27, 2012

Where i can change the language please. I don't found the config file. Thx

► Sign in to add a comment