Skip to content

MichaelYochpaz/iSubRip

Repository files navigation

iSubRip

A Python package for scraping and downloading subtitles from AppleTV / iTunes movie pages.
Latest version: 2.5.4 (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

A TOML config file can be created and used to configure different options and features. 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

[subtitles.webvtt]
subrip-alignment-conversion = true

An example config with details and explanations for all available settings can be found here.

Logs

A log file, containing debug information, will be created for each run on one of the following paths (according to OS):

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

Log rotation (deletion of old files, once a certain amount of files is reached) can be configured in the config file using the general.log-rotation-size setting. The default log rotation value is 15.