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.


Git Installation

# clone the repo
$ git clone

# 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


usage: [-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

Support & Contributions

  • Please ⭐️ this repository if this project helped you!
  • Contributions of any kind welcome!