# iSubRip
A Python package for scraping and downloading subtitles from AppleTV / iTunes movie pages.
Latest version: 2.5.2 ([changelog](https://github.com/MichaelYochpaz/iSubRip/blob/main/CHANGELOG.md))
<br/>
[](https://python.org/pypi/isubrip)
[](https://python.org/pypi/isubrip)
[](https://python.org/pypi/isubrip)
[](https://python.org/pypi/isubrip)
[](https://github.com/MichaelYochpaz/iSubRip/blob/main/LICENSE)
[](https://github.com/MichaelYochpaz/iSubRip/issues)
[](https://github.com/MichaelYochpaz/iSubRip)
<p align="center">
<a href="#"><img src="https://github-production-user-asset-6210df.s3.amazonaws.com/8832013/290989935-e6a17af6-1ebb-456d-a024-dc6e84dd64b2.gif" width="800"></a>
</p>
## 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](https://toml.io) 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:
```toml
[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
```
A complete config with all the available options and explanations for each configuration can be found [here](https://github.com/MichaelYochpaz/iSubRip/blob/main/config.toml).
## 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`.
Raw data
{
"_id": null,
"home_page": "https://github.com/MichaelYochpaz/iSubRip",
"name": "isubrip",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "iTunes,AppleTV,movies,subtitles,scrape,scraper,download,m3u8",
"author": "Michael Yochpaz",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/5e/1a/63500202ac362eafcc2be0102896d025540066ee58dd6229eead0c2ccd56/isubrip-2.5.2.tar.gz",
"platform": null,
"description": "# iSubRip\nA Python package for scraping and downloading subtitles from AppleTV / iTunes movie pages. \nLatest version: 2.5.2 ([changelog](https://github.com/MichaelYochpaz/iSubRip/blob/main/CHANGELOG.md)) \n\n<br/>\n \n[](https://python.org/pypi/isubrip)\n[](https://python.org/pypi/isubrip)\n[](https://python.org/pypi/isubrip)\n[](https://python.org/pypi/isubrip)\n[](https://github.com/MichaelYochpaz/iSubRip/blob/main/LICENSE)\n[](https://github.com/MichaelYochpaz/iSubRip/issues)\n[](https://github.com/MichaelYochpaz/iSubRip)\n\n<p align=\"center\">\n <a href=\"#\"><img src=\"https://github-production-user-asset-6210df.s3.amazonaws.com/8832013/290989935-e6a17af6-1ebb-456d-a024-dc6e84dd64b2.gif\" width=\"800\"></a>\n</p>\n\n\n## Requirements\n* Python 3.8+\n\n## Installation\n### PyPI (Recommended)\n```\npython3 -m pip install isubrip\n```\n\n### Git Source Code\n```\npython3 -m pip install -e git+https://github.com/MichaelYochpaz/iSubRip.git#egg=isubrip\n```\n\n## Usage\n```\nisubrip <iTunes movie URL> [iTunes movie URL...]\n``` \n\n## Configuration\nA [TOML](https://toml.io) config file can be created and used to configure different options and features.\nA config file will be looked for in one of the following paths (according to OS): \n\n**Windows**: `%USERPROFILE%\\.isubrip\\config.toml` \n**Linux / macOS**: `$HOME/.isubrip/config.toml` \n\n### Examples:\n**Windows**: `C:\\Users\\Michael\\.isubrip\\config.toml` \n**Linux**: `/home/Michael/.isubrip/config.toml` \n**macOS**: `/Users/Michael/.isubrip/config.toml` \n\n---\n\n### Example Config:\n```toml\n[downloads]\nfolder = \"C:\\\\Subtitles\\\\iTunes\"\nlanguages = [\"en-US\", \"fr-FR\", \"he\"]\nzip = false\n\n[subtitles]\nconvert-to-srt = true\nfix-rtl = true\n\n[subtitles.webvtt]\nsubrip-alignment-conversion = true\n```\n\nA complete config with all the available options and explanations for each configuration can be found [here](https://github.com/MichaelYochpaz/iSubRip/blob/main/config.toml).\n\n## Logs\nA log file, containing debug information, will be created for each run on one of the following paths (according to OS):\n\n**Windows**: `%USERPROFILE%\\.isubrip\\logs` \n**Linux / macOS**: `$HOME/.isubrip/logs` \n\nLog 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`.",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python package for scraping and downloading subtitles from AppleTV / iTunes movie pages.",
"version": "2.5.2",
"project_urls": {
"Bug Reports": "https://github.com/MichaelYochpaz/iSubRip/issues",
"Homepage": "https://github.com/MichaelYochpaz/iSubRip",
"Repository": "https://github.com/MichaelYochpaz/iSubRip"
},
"split_keywords": [
"itunes",
"appletv",
"movies",
"subtitles",
"scrape",
"scraper",
"download",
"m3u8"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "12c90a802fc013ee6609d01809061e5162c0a6efae08b5c272b63ea6c3de29c0",
"md5": "3a3f86de90920dc835cbdb99ebf2d735",
"sha256": "f86c997ef012356feeb6e88e6e8065a746a4140aac53878055b12878e1879f57"
},
"downloads": -1,
"filename": "isubrip-2.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3a3f86de90920dc835cbdb99ebf2d735",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 40992,
"upload_time": "2024-01-06T19:36:12",
"upload_time_iso_8601": "2024-01-06T19:36:12.783518Z",
"url": "https://files.pythonhosted.org/packages/12/c9/0a802fc013ee6609d01809061e5162c0a6efae08b5c272b63ea6c3de29c0/isubrip-2.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5e1a63500202ac362eafcc2be0102896d025540066ee58dd6229eead0c2ccd56",
"md5": "62ed66442b40d0fb5c496bbe213b82e5",
"sha256": "d965b360db55f20328f07a7f608f6e638cacd90f8db8144a253ecd73532b392a"
},
"downloads": -1,
"filename": "isubrip-2.5.2.tar.gz",
"has_sig": false,
"md5_digest": "62ed66442b40d0fb5c496bbe213b82e5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 32349,
"upload_time": "2024-01-06T19:36:14",
"upload_time_iso_8601": "2024-01-06T19:36:14.493477Z",
"url": "https://files.pythonhosted.org/packages/5e/1a/63500202ac362eafcc2be0102896d025540066ee58dd6229eead0c2ccd56/isubrip-2.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-06 19:36:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MichaelYochpaz",
"github_project": "iSubRip",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "isubrip"
}
JSON
