Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sameera-madushan/subtitlebox
Python script to download subtitles for your movies.
https://github.com/sameera-madushan/subtitlebox
downloader python subdbapi subtitle-downloader subtitles
Last synced: 6 days ago
JSON representation
Python script to download subtitles for your movies.
- Host: GitHub
- URL: https://github.com/sameera-madushan/subtitlebox
- Owner: sameera-madushan
- License: mit
- Created: 2020-04-13T18:17:32.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-03-17T10:16:01.000Z (8 months ago)
- Last Synced: 2024-03-17T11:27:36.699Z (8 months ago)
- Topics: downloader, python, subdbapi, subtitle-downloader, subtitles
- Language: Python
- Homepage:
- Size: 65.4 KB
- Stars: 236
- Watchers: 9
- Forks: 34
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
*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](http://thesubdb.com/) 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
- [x] Download subtitle files of different languages.
- [x] Download subtitles for multiple movies at once.
- [x] 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. :heart:
Jonathan Partain
Alessandro Falcetta
Murilo Pagliuso
mihakodric
Nicolas Brown