testerez / grabbysub2

Grab movie/tv subtitles, hand crafted for you!

GrabbySub2.0 - Grab your sub from the terminal, and grab the right one! ✌️ 💥 🚀

GrabbySub is a small little tool for you 🎦/📺 lovers out there who hates scrolling through all hundreds of choices just to find the right language, resolution and uploading version.

I technically live in the terminal, so I really find it painful to go through all the old school web browsing just to get my movie subtitle whenever I decide to relax. With that, I decided to write a little script to help me get my subtitle faster and also learn a thing or two from that. This is essentially just a learning tool for me, but if it improves my movie watching experience throughout the process, who cares?.

The first version was written in Bash and so as handy as it was, it wasn't really that swift and user-friendly. Thus, GrabbySub2 is born, built on Python this time. The loading speed is greatly improved, with a much more pleasant user interacting interface.

Getting Started

With this update, it truly transformed that sub grabbing process. You just call up the sub-servant, type in your movie/show, pick the specs and bam! You got yourself the right sub. Subscene has the right idea with the open-contribution community, which allows for precision. However, the precision should really come with ease.

Prerequisites

• Python - If you didn't have it already, you should download it.
• Pip - The python module downloader
• Pup - HTML parser for shell

Installation

We first needs to download a couple of stuffs first

Install Brew (OS X users only)

Open terminal and type:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Download Python & Pip

OS X

brew install python
curl -s -L 'https://bootstrap.pypa.io/get-pip.py' -O 
python get-pip.py

Linux (Debian)

apt-get install python -y 
curl -s -L 'https://bootstrap.pypa.io/get-pip.py' -O 
python get-pip.py

Linux (RPM)

yum install python
curl -s -L 'https://bootstrap.pypa.io/get-pip.py' -O 
python get-pip.py

Downloading additional modules:

Make sure you run pip as root and download all of these modules:

sudo pip install beautifulsoup4 zipfile re requests

Lastly, we need to install pup HTML-parser:

If you have Go installed, use:

go get github.com/ericchiang/pup

For OS X users, use

brew install https://raw.githubusercontent.com/EricChiang/pup/master/pup.rb

To build from source, visit pup's repo and download your correct version.

Note: The packages differ from machine to machine. You might have already gotten them, some people haven't so it doesn't hurt to go through this process just to make sure it runs swiftly.

Usage

Creating an alias for ease of use:

alias grabby='python ~/Downloads/Grabby2.0.py' 

Open up terminal, go to your movie directory, and just run grabby

Type in your show | movie & select the correct season/version

Select the type of media (TV/Mov) and the Language

Select your episode and resolution, then pick a link:

Et voila! 👼 👏

Adding Languages & Encoding Version

Your language might not be included, or maybe you want to add some vendor specific stuffs like (HDTV, YIFY, DEMAND...) in the res section, don't worry, just do this:

Adding Languages

Just fire up your text editor, search for the pattern: language = [ and add your language there, in quotes of course.

E.g:

language = ["English","Chinese","Arabian","French","Spanish","Danish","German","Vietnamese","etc...."]

Adding resolution

Do the same with language, but this time search for: res = [ and add your resolution there.

res = ["480p","720p","1080p","HDTV","JYK","etc..."]

Bugs & Improvements

• Even faster ❗ The current version isn't so bad. Version 2.0 runs on python so it's almost double the speed of the first one which was as slow as a bash script can get

• Work on a GUI, integrate into a small handy taskbar/dock utility which improves users' experience...

• ... Suggestions ❓

Contact me

If you have any questions, shoot me a message at [email protected]

As always, thanks for reading/using/checking out/frowning 😹 😍 💫 💩

All done! Enjoy!