/iSubRip

A Python package for scraping and downloading subtitles from AppleTV / iTunes movie pages.

Primary LanguagePythonMIT LicenseMIT

iSubRip

A Python package for scraping and downloading subtitles from AppleTV / iTunes movie pages.
Latest version: 2.4.3 (changelog)


PyPI - Version PyPI - Monthly Downloads PyPI - Total Downloads PyPI - Python Version GitHub - License GitHub - issues GitHub - Repo stars

Requirements

  • Python 3.8+

Installation

PyPI (Recommended)

python3 -m pip install isubrip

Git Source Code

python3 -m pip install -e git+https://github.com/MichaelYochpaz/iSubRip.git#egg=isubrip

Usage

isubrip <iTunes movie URL> [iTunes movie URL...]

Configuration

It's possible to configure different options and features by creating a TOML config file.
A config file will be looked for in one of the following paths (according to OS):

Windows: %USERPROFILE%\.isubrip\config.toml
Linux / macOS: $HOME/.isubrip/config.toml

Examples:

Windows: C:\Users\Michael\.isubrip\config.toml
Linux: /home/Michael/.isubrip/config.toml
macOS: /Users/Michael/.isubrip/config.toml

Example Config:

[downloads]
folder = "C:\\Subtitles\\iTunes"
languages = ["en-US", "fr-FR", "he"]
zip = false

[subtitles]
convert-to-srt = true
fix-rtl = true

A complete config with all the available options and explanations for each configuration can be found here