https://github.com/Diaoul/subliminal

Subliminal is a python library to search and download subtitles. It comes with an easy to use CLI (command-line interface) suitable for direct use or cron jobs.

 

Subliminal uses multiple providers to give users a vast choice and have a better chance to find the best matching subtitles. Providers are extensible through a dedicated entry point.

 

    Addic7ed

    OpenSubtitles

    Podnapisi

    TheSubDB

    TvSubtitles

 

If you are into TV Shows, you would know that Addic7ed is the first place to look for subtitles. This wins over periscope (which hasn't been updated in a while). This is an especially must have if you use sickbeard and always download subtitles manually yourself. I can't be sure if it does movies too though.

 

0.8.0 Requirements are:

beautifulsoup4>=4.3.2

guessit>=0.6.2

requests>=2.0.1

enzyme>=0.4.0

html5lib>=0.99

dogpile.cache>=0.5.2

babelfish>=0.5.1

charade>=1.0.3

pysrt>=1.0.0

pyxdg>=0.25

 

If someone can post how to install "pip", the installation of these packages would be very very easy. But even then it will not survive a reboot. I am hoping that someone familiar with all these would make one that installs everything and survives a reboot, and do a cronjob every hour or so. We can easily adjust the command line ourselves to customise the application settings here https://readthedocs.org/projects/subliminal/. Note that there are 2 versions - stable 0.7.3 for the 0.7.x branch, and unreleased 0.8.0 for the master branch (however also not available to pip since it's not in the python site). It would be great if we could also choose the branch we want and update them when the repo is updated (or when the python site is updated). Anyone willing to take up the challenge for the greater good? 

you need python packages

 

then add to "go" file or manual execute

 

wget https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py --no-check-certificate -O - | python
url https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python

 

next you know how example

pip install flexget

 

Done

Thanks I am giving it a try! However it seems like with pip1.5.1 onwards the setuptools is not required, just this will do:

 

curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python

 

That's all setup nicely, but upon the

pip install subliminal

command, both subliminal and its dependency babelfish are giving me installation errors. I am not familiar with python at all so if someone can shed light on this that would be great! From what I am guessing is that it is due to directories being wrong? And if so, how would I fix it?

 

In case the errors are required: http://pastebin.com/BZhz03VD

 

Update1: Rebooted the server and attempted to try it on the 0.8.0 git version instead

http://pastebin.com/WsHH1n0N

 

Update2: I got it to work, will be posting manual instructions later. I don't know how to make them into a script so if someone can do that, that would be awesome! If someone can do something like get the cronjob started when sickbeard is done, and then keep checking every hour until the subtitles are downloaded, then stop, that would be awesome. I remember seeing this somewhere but I can't find it.

 

 

im not get any error/issue like you

 

just look

http://pastebin.com/Ga7Rpn2y

 

but im using python 2.7.3

Short Instructions:

#latest subliminal 0.8.x requires python2.7 (you need to download it from somewhere first and place it into some folder)
#you may skip this if you already have it. to check, type "python --version" or "python2.7 --version"
installpkg /boot/packages/python-2.7.3-i686-5PTr.txz

#subliminal also requires setuptools package which the pip package will install for you (as of now its pip1.5.2)
#so we download the installation file in some temp folder first, then explicitly install it using python2.7 (not 2.6)
cd /tmp/
wget --no-check-certificate https://raw.github.com/pypa/pip/master/contrib/get-pip.py
python2.7 get-pip.py

#now we need to download latest subliminal to cache drive (actually i dont think we have to? in fact we can just place it in the /tmp/ folder)
cd /mnt/cache/
git clone https://github.com/Diaoul/subliminal.git

#once we get the folder, navigate to into the downloaded folder
cd subliminal
#finally, we install!
python2.7 setup.py install

 

You have to do this every-single-time you turn on or restart your server though. I heard you can put these into the go file but I have no idea how that will work.

 

[Note I haven't actually tested the cronjob thing yet but I think it should work, if not, please correct me!]

Next you want it to check your TV shows directory every hour or so, what I did is edit the crontab file and execute a file every 1 hour:

crontab -e
#then traverse to the very end and add this (it opens the file in vi I believe, so you need to learn some commands on vi, if not I think it somewhere in the flash drive? you can then just edit via Notepad++):
# Start of hourly subliminal cronjob
0 * * * * cd /mnt/cache/subliminal/ && ./subliminaljob.sh 1> /dev/null
# End of subliminal entry

Here is the subliminajob.sh file that you must edit to your own liking (check their readthedocs for cli parameters, or directly type in console subliminal --help) and here is mine

#!/bin/bash

#Basically here I am logging into the addic7ed provider (there are several other providers to choose from), then check the specified directory for english subtitles (hearing impaired) for those videos that are modified/created within the past 5 days. Download them and name them exactly as that of the video file (without appending .en), and output them to a logfile (actually not required)
subliminal -p addic7ed --log-file /mnt/cache/subliminal/cronjobs.log -l en -v -s -h -a 5d --addic7ed-username myuserhere --addic7ed-password mypasswordhere /mnt/user/pathtomyTVShows/

 

I hope the above helped out some people..! Let me know if there is any questions.

I am really interested in this.... I have significant hearing loss on one ear and rely on subs. TV shows can be notoriously unreliable when I manually download after the fact.

 

From posts above, is this working? How do I implement this into my Sab/Sickbeard/Couchpotato process, where the subtitle is matched to the exact downloaded release. This would be wonderful thing.

 

Many thanks,

 

H.

I did not attempt to implement it into the sickbeard process because they are usually "fresh out of the oven" and subs won't be available that soon. Addic7ed is the best place for TV subs, so if you need manual subs, get it from them. They usually release the complete subs within 12 hours, and what I am trying to do here is to check every hour for subtitles from addic7ed, so when I want to watch it a few hours later or the next day, it's already there (and just play in my Plex client).

 

The instructions itself is working (at least for me so far!), and I have downloaded subs manually using the command above. As for the hourly checking job, I haven't test it yet, but I will try to update my post on the result in the next 16 hours I hope it works because that's the point of all this - to automate the whole process. Currently I am going to the addic7ed site to check every or so often and manually downloading it myself, rename the subs then cut into the share folders, which is a bit tedious when everything else is already automated. Note that the only thing bad is that you have to do the install process all again if you where to reboot your server. I am hoping someone can help me out with this.

 

If there is anything at all you don't understand let me know. I am still a very new newbie myself.

Thank you Cyber... I just went over to addic7ed and read about how they do not want this as part of the xbmc subtitles addon...  Can you please describe to me your workflow for getting the subtitles?

 

My issue is that I download the shows, it may be month until I actually get to watch them. By that time, I have no clue which group released the episode SB downloaded. As I watch, if the subtitle is not in the mkv, I go to the subtitle addon to download them (from my htpc).... then I pray I find one that is synchronized... if I cannot find a synched one, then I am farting through the whole episode with the subtitle delay option. Not great.

 

I had never heard of addic7ed until your post. 

 

Thanks again.

 

just ran into this post... re-enabling addicted in xbmc

http://be4i.blogspot.com/2013/05/addic7ed-service-for-xbmc-subtitles.html

Wow didn't know xbmc could do that.. been wanting Plex to do that as well but seems like no one is doing it. Great to know it worked out fine for you

Wow didn't know xbmc could do that.. been wanting Plex to do that as well but seems like no one is doing it. Great to know it worked out fine for you

 

Just tried it and it does not seem to be working.... but try it yourself in case...

I use Plex Media Server not XBMC, so couldn't help you at all there. However if you like you can try my method above and it might work for you! No guarantees not to break anything though

 

With the above steps given you are basically installing Subliminal (which is a script to get the most likely subtitles for you), and also the prerequisites needed for it to run. Then set it to automatically check your TV folders every hour for subs and download them - as simple as that!

Thanks... I have been chasing and reading same posts and threads you have looked at. Do you run Sickbeard? The part I am missing is where Subliminal steps in between Sab and Sickbeard. When a download is completed in Sab, it runs the script SabToSickbeard. Do you have to replace SabToSickbeard with another script? Which folder did you specify in the Subliminal watch folder configuration? /downloads/incomplete or /downloads/complete/TV?

 

Sorry for all the questions... but I cannot seem to find the answer.

 

Thanks again.

Well... it seems like there is an entire new fork of Sickbeard that has subtitle downloading built in (via Subliminal) along with PirateBay torrenting.... The interface is very up to date, and very strongly supported and followed.

 

https://github.com/mr-orange/Sick-Beard

 

http://sickbeard.com/forums/viewtopic.php?t=2386

 

In unRAID, I disabled the SB plugin, then I changed the folder location and for the data directory. I enabled the plugin and applied the settings. This forced a redownload of SB into the new folder. I stopped the plugin again, and erased the contents of the new folder. I replaced it with contents of new fork zip file and re-started the plugin.

 

There is no way to migrate the setting from old to new, so I had to manually configure and re-added my shows.

 

It really does look like this is the evolution of SB... But just in case, its nice in  that I can go back to my old SB just by changing the folder.

 

 

 

 

Sorry for the late reply! So I just checked and the cronjob indeed ran and it got me the The Following subs correctly (it's missing Intelligence but I guess it's a Subliminal thing due to the extra naming with the (US)).

 

I knew that that feature already exists in the piratebay edition, but I'm using the official branch via unplugged's sickbeard, and don't know how to upgrade/change to that piratebay branch without screwing my existing settings and shows up. Lazy to re-setup again lol. If I am not wrong, visuals aside, it has more support for torrents and that it has subtitles support, which is not a lot of incentive for me to upgrade at the moment..unless the way it does subtitles is more robust!

Cyber it is insanely robust on the subtitle part... the only drawback is that you do have to start with a new database by scanning exist shows... which means it looses the release info (I think).

 

The whole setup took me 10 minutes, plus a long while to scan all my existing shows. I do think its worth the effort. The process is simple. I outline it in my post above.

 

 

@hernandito: i cant get it to work like you outlined it. i did exactly what you said and its not starting. i also tried in another tryout this way: http://sickbeard.com/forums/viewtopic.php?p=12901&sid=1e234bb89ca3f2efe43a721e25ab1368#p12901

 

also not possible to start it. with and without copying the .db and .ini file, it looks like the process is not coming up. the logs don't say anything

 

any hints?

You should still be using the original sickbeard plg from unplugged

 

In the SB plugin section, change the folder for both install directory and data directory to a new unused folder... mine is /mnt/cache/.custom/sickbeard2.

 

Then enable and Apply the changes. This should download everything from master sickbeard. If it started the service, stop it. Download the zip from the new fork. In Putty using Midnight Commander, go to this new folder and erase everything that was in it. Then copy the contents of the new zip (extracted) to the same folder.

 

Start Sickbeard...  It worked for me.

 

 

Well... it seems like there is an entire new fork of Sickbeard that has subtitle downloading built in (via Subliminal) along with PirateBay torrenting.... The interface is very up to date, and very strongly supported and followed.

 

https://github.com/mr-orange/Sick-Beard

 

http://sickbeard.com/forums/viewtopic.php?t=2386

The top link doesn't work anymore, and trying to pull this URL gives a 404:  https://github.com/mr-orange/Sick-Beard.git

 

Anyone know what's going on?

that SickBeard version has been pulled back from github

it no longer exists