This project is archived due to the SubDB API being inactive. Thanks to everyone who contributed!

SBOX - Subtitle Box

SBOX is a python script to download subtitles for your movies from SubDB database using their API. SubDB is a free, centralized subtitle database intended to be used only by opensource and non-commercial softwares.

Please Note: Subtitle file will be downloaded in to the same folder as the correspondent video file.

Features

• Download subtitle files of different languages.
• Download subtitles for multiple movies at once.
• Command line mode for terminal users.

Git Installation

# clone the repo
$ git clone https://github.com/sameera-madushan/SubtitleBOX.git

# change the working directory to SubtitleBOX
$ cd SubtitleBOX

# install the requirements
$ pip3 install -r requirements.txt

(OSX/Linux only) Install tkinter

If you are running python 3.7 or later, nothing has to be done. Earlier python3 versions require installation.

# Debian/Ubuntu
$ sudo apt install python3-tk

# macOS
# Follow the instructions on https://tkdocs.com/tutorial/install.html

Usage

python sbox.py

usage: sbox.py [-h] [-f FILE_PATH] [-lang LANGUAGE_CODE]

SubtitleBOX CLI

optional arguments:
  -h, --help            show this help message and exit
  -f FILE_PATH, --file_path FILE_PATH
                        Path of the video file for which subtitles should be
                        looked for
  -lang LANGUAGE_CODE, --language_code LANGUAGE_CODE
                        Language code for subtitles. Can be en, es, fr, it,
                        nl, pl, pt, ro, sv, tr

Contributors

Thanks goes to these wonderful people. ❤️

Jonathan Partain

Alessandro Falcetta

Murilo Pagliuso

mihakodric

Nicolas Brown