Forum rules
Under no circumstances is spamming or advertising of any kind allowed. Do not post any abusive, obscene, vulgar, slanderous, hateful, threatening, sexually-orientated or any other material that may violate others security. Profanity or any kind of insolent behavior to other members (regardless of rank) will not be tolerated. Remember, what you don’t find offensive can be offensive to other members. Please treat each other with the kind of reverence you’d expect from other members.
Failure to comply with any of the above will result in users being banned without notice. If any further details are needed, contact: “The team” using the link at the bottom of the forum page. Thank you.
Posts: 82
Joined: Mon Apr 17, 2006 5:33 am

SubDownloader 2.1.0

Fri Jul 04, 2008 11:56 am

SubDownloader official webpage

SubDownloader 2.1.0 - download

Help to translate SubDownloader into your language.

SubDownloader is a unique programme designed to easily locate, match and download subtitles for the videos you have using API.

The need for exact matching has been felt by everyone who uses subtitles. Most movies have multiple versions in circulation due to different releases for different markets and different edits for different purposes. The subs created for one version often will not synchronise with the audio track for another version. This problem is compounded by the fact that same movies exist under different names with minor or major variations. The resulting mismatches can be very frustrating.

SubDownloader works with to maintain a database of subtitles matched to specific versions of movies. You will find an exact match as the programme uses a special moviehash check to match a movie file to a subtitles file which has been up-loaded to the database using the same programme. The database is ever-expanding and the more you and others use it the more useful it will become for the community of subtitles users.

Please try it today. Find subtitles you need and upload good quality subtitles you may have so that others can benefit. Even if a subtitle file already exists on, please upload it using SubDownloader so that the database will connect it to the movie version that you have got with its specific hash, fps, file size, time duration etc.

The main features of the programme are:
- finds exact match
- can search and download subtitles for 1 movie or whole directories -
- can upload subtitles to the database, it is so simple anyone can do it
- fast hashing and search
- works with Windows / Linux / MacOS
- no spyware, malware or adware

User FAQ:

How do I get started?
Windows users download the installer file from the link at the top of this page or here and install. MacOS users follow this link and Linux users follow this link. After installing set the preferences including login name etc. if you are registered with OpenSubtitles.

When you start the programme you will see the following:


The top tabs offer the choice to “search by video file” (default), “search by movie name” or “upload subtitles”. The left panel shows the drive/directory tree on your system.

How does the program work?
You first configure the programme to your preferences under menu item "Settings" the most important of which is the language or languages of the subtitles you want to search.

Then you can start with the "Search by Video" tab. Select a whole directory or a specific movie. If you select a directory the programme will identify all video files in that directory and display the list of video files in that directory/folder in the right hand panel. The programme then takes off as follows:
1. SubDownloader applies to each video file a moviehash function getting a unique 64 bit string.
2. It submits this string to an online subtitles database with a request to match.
3. It displays the subtitles found along with each movie.
4. You select the subtitle file or files you want and download by clicking the “Download” button.

In this process the name of the movie is not important. So if you rename your movie, you will still find the same subtitles too, as long as the contents of file are not changed.

SubDownloader did not find subtitles for my movie XXX! Does it mean you don't have subtitles for XXX on your website?
No, it means, subtitles for movie XXX was not uploaded with SubDownloader and therefore not matched to the movie version you have. They could be on the OpenSubtitles website.
1. Change the tab on top to “search by movie name”.
2. Enter the movie name and click search, locate and download manually.
3. Please help the community - check it out and if you are satisfied about its quality and fit, upload it with SubDownloader. The more people do this the more useful the site will be for the entire community.

post your problem in this thread or fill out a bug report here

Author of the instructions: a m spock
Last edited by capiscuas on Mon Apr 23, 2012 10:41 am, edited 18 times in total.

User avatar
Posts: 715
Joined: Sat Feb 10, 2007 1:40 am
Location: Information Technology
Contact: ICQ Website WLM Yahoo Messenger AOL

Wed Jul 09, 2008 12:52 am

Congratulations! It's great to see development continuing. The new versions is a very nice evolution over the older one.

User avatar
Posts: 715
Joined: Sat Feb 10, 2007 1:40 am
Location: Information Technology
Contact: ICQ Website WLM Yahoo Messenger AOL

Wed Jul 09, 2008 1:43 am

Incidentally. After much head scratching and taking advantage of a broken leg that has forced me to stay home, I have this running right now:


There are some bugs I can't log in launchpad. The biggest one is that videofiles are not recognized in Mac OS X so they can't be selected.

There are other minor ones like mounted network disks not being shown. I'll log them as bugs as soon as I can. I'll get to work in the Mac executable, tho'.

Posts: 82
Joined: Mon Apr 17, 2006 5:33 am

Wed Jul 09, 2008 3:49 am

Very good job eduo. I've added you as a team member of Subdownloader LaunchPad.

As soon as you can please report all those bugs you've found.
They will be fixed in record time :-)

Best Regards.

Posts: 1
Joined: Mon Jul 14, 2008 8:50 am

Mon Jul 14, 2008 8:55 am

I've got Subdownloader 2.0 rev 308 successfully built and running on OS X Leopard (Intel.)

Using py2app, I've been able to build a working package using alias mode via the instructions here: ... up-py-file

The alias version functions perfectly, but when I try to build a stand-alone version for redistribution, I get the following console error:

Traceback (most recent call last):
File "/Users/reed/Downloads/subdownloader/dist/", line 137, in <module>
File "/Users/reed/Downloads/subdownloader/dist/", line 134, in _run
execfile(path, globals(), globals())
File "/Users/reed/Downloads/subdownloader/dist/", line 27, in <module>
import subdownloader.modules.configuration as conf
ImportError: No module named subdownloader.modules.configuration
2008-07-13 23:39:20.959 run[79397:10b] run Error
2008-07-13 23:39:20.960 run[79397:10b] run Error
An unexpected error has occurred during execution of the main script

ImportError: No module named subdownloader.modules.configuration

I'm pretty close to having this all together. Any help on resolving this problem?

User avatar
Posts: 715
Joined: Sat Feb 10, 2007 1:40 am
Location: Information Technology
Contact: ICQ Website WLM Yahoo Messenger AOL

Mon Jul 14, 2008 1:44 pm

sofauxboho: I've also replied to the bug in Launchpad.

I'm stuck in the exact same place for a week now.

I've tried doing several things (in fact mimicking the py2exe set-up) without much luck. The Py2exe file contains instructions to go above a directory, which is supposed to take care of this, but I haven't been able to replicate: ... zz4376xl-1

These lines are supposed to take care of this:
import os, sys
os.chdir("..") #We are in the distribution subfolder, we want to be in subdownloader folder.
(parent, current) = os.path.split(os.path.dirname(os.getcwd()))
sys.path.insert(0, os.path.dirname(parent))
sys.path.insert(0, os.getcwd())

This is not fixing the error, and I haven't been able to put as much time into this as I'd like. This file may point you in the right direction, as statements are supposed to be pretty similar between py2ex and py2app. It may just be a matter of adding the proper path.

When checking the executable it's clear all dependencies are included correctly except for Subdownloader's themselves: ... 505ac4.png

I haven't looked around and this changing of directories for access to the modules is not common, so I'm not sure how to adopt it. Everything I've tried so far doesn't wok, including putthing the "modules" folder directly in the compiled app.

The final app is around 45MB, by the way.

Posts: 1
Joined: Mon Jul 14, 2008 3:19 pm

Mon Jul 14, 2008 3:27 pm


Thx for the big update to Subdownloader! Real nice, all seems to work very well (running 2.0.1 on windows). Only thing is that it doesnt seem to take a file (or directory) as a parameter, thats how i always used 1.x, would be a great addition.

Also, a command line version for windows would be greatly appreciated.

Thx again for the app!

Posts: 39
Joined: Thu Jan 04, 2007 2:59 am

Tue Jul 15, 2008 10:43 pm

Nice to hear it!

Please, can you add function for save hashes ( ?
Do good things, and good things happen to you

Posts: 82
Joined: Mon Apr 17, 2006 5:33 am

Wed Jul 16, 2008 5:34 am

Hi James, the hash cache is in our whishlist, please give your opinion here.

The developers doesn't follow this forum too often, but with the bug request they get notified immediately.

Posts: 1
Joined: Thu Oct 05, 2006 7:39 pm

Mon Jul 21, 2008 7:12 pm

1. How come I get a different screen image from the one posted by eduo?

2. And why am I logged in as anonymous?

3. Would like to be able to select default language or languages?

4. Would like to be able to select default folder!

Posts: 5
Joined: Mon Apr 30, 2007 1:24 pm

Thu Jul 24, 2008 11:33 am

Based on my short experience with SubDownloader 2.0.1 on Windows I would say that it should never have been released due to its incomplete status.

I would file a bug report against specific features if that was possible but since the whole program is a mistake that is not possible. Nor is it possible to file a bug report regarding the complete program.

You have included several new features, but left out just as many features of 1.2.9.
- When you want to upload subtitles, subtitle files are no longer automatically found if they are placed in the same folder as the video and are named as the video file + language code.
- A guess on the IMDB page is longer made, forcing you to search manually for each upload. Making each upload take longer time, and unless that has been fixed and not reported, login sessions still has a maximum lifespan leading to subtitles being uploaded by anonymous users.

There is no way of putting this nicely so here it is: I think the new layout is ugly compared to 1.2.9

No external video player can be selected as that feature simply does not respond. I do suspect that this problem might be related to me running Windows Vista as I have seen similar problems with other programs that worked perfectly for me on Windows XP.

2.0.1 has the same bug as 1.2.9, it does not show all the uploaded subtitles. Even subtitles that I have uploaded myself is sometimes missing and that can only happen if the calculated hash is not always the same for the same file.

After having tried 2.0.1 on my computer, I have downgraded to 1.2.9 as I do not have the time nor interest required to be a beta tester.

Posts: 82
Joined: Mon Apr 17, 2006 5:33 am

new version

Thu Jul 31, 2008 8:51 am


I recommend you to try from 2.0.4 version, it fixes all the things you mention.

Posts: 5
Joined: Mon Apr 30, 2007 1:24 pm

Sat Aug 02, 2008 7:07 pm

SubDownloader has increased quite a lot from 2.0.1 to 2.0.4, but I still miss a feature from 1.2.9.

In 1.2.9 you could specify which languages you were interested in subtitles in. Since I am interested in subtitles in 2 languages this is a very usable feature.

In 2.0.4 you can only choose one language and it forgets your choice every time the program is restarted, defaulting to all languages.

While the choice is present in my login on this does not affect which subtitles I am presented with after searching.

Posts: 82
Joined: Mon Apr 17, 2006 5:33 am

2.0.5 released

Sat Aug 09, 2008 3:39 pm

New 2.0.5 version released


FIXED: bug 254685,
FIXED: added malay language
FIXED: path correction, cli progressbar and removed progress bar on debug mode
FIXED: updated flags to show 24x24 size
FEATURE: added improved thread
FEATURE: added paypal icon in statusbar
added login button in statusbar
added qprogressdialog for connection/login
now the About dialog shows the version of the app
added more menu items
Added button of Delete All in upload.
Added button to selected video files or folder in Search tab.
FIXED: Forced the hash algorythm to use LITTLE ENDIAN, so it will work with other processors like PPC
FEATURE: Added the Search Button in the middle.
Now SD will only do a search of the videos if the folder clicked doesn't have any children.

Posts: 82
Joined: Mon Apr 17, 2006 5:33 am

Sat Aug 09, 2008 3:43 pm

zagadka, the feature you mention has priority for our 2.0.6, which will be released during next week.

Best Regards.

Return to “Programs using OS”

Who is online

Users browsing this forum: No registered users and 3 guests