# PGSRip
Rip your PGS subtitles.
[](https://pypi.python.org/pypi/pgsrip)
[](https://github.com/ratoaq2/pgsrip/blob/master/LICENSE)
- Project page
<https://github.com/ratoaq2/pgsrip>
**PGSRip** is a command line tool that allows you to extract and convert
PGS subtitles into SRT format. This tool requires MKVToolNix and
tesseract-ocr and tessdata (<https://github.com/tesseract-ocr/tessdata>
or <https://github.com/tesseract-ocr/tessdata_best>)
## Installation
pgsrip:
$ pip install pgsrip
MKVToolNix:
[Linux/WSL - Ubuntu/Debian]
$ sudo apt-get install mkvtoolnix
[Windows/Chocolatey]
$ choco install mkvtoolnix
tesseract:
PPA is used to install latest tesseract 5.x. Skip PPA repository if you decide to stick with latest official Debian/Ubuntu package
[Linux/WSL - Ubuntu/Debian]
$ sudo add-apt-repository ppa:alex-p/tesseract-ocr5
$ sudo apt update
$ sudo apt-get install tesseract-ocr
[Windows/Chocolatey]
$ choco install tesseract-ocr
tessdata:
$ git clone https://github.com/tesseract-ocr/tessdata_best.git
export TESSDATA_PREFIX=~/tessdata_best
If you prefer to build the docker image Build Docker:
$ git clone https://github.com/ratoaq2/pgsrip.git
cd pgsrip
docker build . -t pgsrip
## Usage
### CLI
Rip from a .mkv:
$ pgsrip mymedia.mkv
3 PGS subtitles collected from 1 file
Ripping subtitles [####################################] 100% mymedia.mkv [5:de]
3 PGS subtitles ripped from 1 file
Rip from a .mks:
$ pgsrip mymedia.mks
3 PGS subtitles collected from 1 file
Ripping subtitles [####################################] 100% mymedia.mks [3:pt-BR]
3 PGS subtitles ripped from 1 file
Rip from a .sup:
$ pgsrip mymedia.en.sup
1 PGS subtitle collected from 1 file
Ripping subtitles [####################################] 100% mymedia.en.sup
1 PGS subtitle ripped from 1 file
Rip from a folder path:
$ pgsrip -l en -l pt-BR ~/medias/
11 PGS subtitles collected from 9 files / 2 files filtered out
Ripping subtitles [####################################] 100% ~/medias/mymedia.mkv [4:en]
11 PGS subtitles ripped from 9 files
Using docker:
$ docker run -it --rm -v /medias:/medias -u $(id -u username):$(id -g username) ratoaq2/pgsrip -l en -l de -l pt-BR -l pt /medias
11 PGS subtitles collected from 9 files / 2 files filtered out
Ripping subtitles [####################################] 100% /medias/mymedia.mkv [4:en]
11 PGS subtitles ripped from 9 files
### API
``` python
from pgsrip import pgsrip, Mkv, Options
from babelfish import Language
media = Mkv('/subtitle/path/mymedia.mkv')
options = Options(languages={Language('eng')}, overwrite=True, one_per_lang=False)
pgsrip.rip(media, options)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ratoaq2/pgsrip",
"name": "pgsrip",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.1,<4.0.0",
"maintainer_email": "",
"keywords": "video,mkv,subtitles,rip,srt,pgs,sup,sub,metadata,movie,episode,tv,shows,series",
"author": "Rato",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/1a/07/9262420ae398055d20f6c72d8d1fd05419854a4acc513b33ff900687436a/pgsrip-0.1.6.tar.gz",
"platform": null,
"description": "# PGSRip\n\nRip your PGS subtitles.\n\n[](https://pypi.python.org/pypi/pgsrip)\n\n[](https://github.com/ratoaq2/pgsrip/blob/master/LICENSE)\n\n - Project page \n <https://github.com/ratoaq2/pgsrip>\n\n**PGSRip** is a command line tool that allows you to extract and convert\nPGS subtitles into SRT format. This tool requires MKVToolNix and\ntesseract-ocr and tessdata (<https://github.com/tesseract-ocr/tessdata>\nor <https://github.com/tesseract-ocr/tessdata_best>)\n\n## Installation\n\npgsrip:\n\n $ pip install pgsrip\n\nMKVToolNix:\n\n [Linux/WSL - Ubuntu/Debian]\n $ sudo apt-get install mkvtoolnix\n\n [Windows/Chocolatey]\n $ choco install mkvtoolnix\n\ntesseract:\n\nPPA is used to install latest tesseract 5.x. Skip PPA repository if you decide to stick with latest official Debian/Ubuntu package\n\n [Linux/WSL - Ubuntu/Debian]\n $ sudo add-apt-repository ppa:alex-p/tesseract-ocr5\n $ sudo apt update\n $ sudo apt-get install tesseract-ocr\n\n [Windows/Chocolatey]\n $ choco install tesseract-ocr\n\n\ntessdata:\n\n $ git clone https://github.com/tesseract-ocr/tessdata_best.git\n export TESSDATA_PREFIX=~/tessdata_best\n\nIf you prefer to build the docker image Build Docker:\n\n $ git clone https://github.com/ratoaq2/pgsrip.git\n cd pgsrip\n docker build . -t pgsrip\n\n## Usage\n\n### CLI\n\nRip from a .mkv:\n\n $ pgsrip mymedia.mkv\n 3 PGS subtitles collected from 1 file\n Ripping subtitles [####################################] 100% mymedia.mkv [5:de]\n 3 PGS subtitles ripped from 1 file\n\nRip from a .mks:\n\n $ pgsrip mymedia.mks\n 3 PGS subtitles collected from 1 file\n Ripping subtitles [####################################] 100% mymedia.mks [3:pt-BR]\n 3 PGS subtitles ripped from 1 file\n\nRip from a .sup:\n\n $ pgsrip mymedia.en.sup\n 1 PGS subtitle collected from 1 file\n Ripping subtitles [####################################] 100% mymedia.en.sup\n 1 PGS subtitle ripped from 1 file\n\nRip from a folder path:\n\n $ pgsrip -l en -l pt-BR ~/medias/\n 11 PGS subtitles collected from 9 files / 2 files filtered out\n Ripping subtitles [####################################] 100% ~/medias/mymedia.mkv [4:en]\n 11 PGS subtitles ripped from 9 files\n\nUsing docker:\n\n $ docker run -it --rm -v /medias:/medias -u $(id -u username):$(id -g username) ratoaq2/pgsrip -l en -l de -l pt-BR -l pt /medias\n 11 PGS subtitles collected from 9 files / 2 files filtered out\n Ripping subtitles [####################################] 100% /medias/mymedia.mkv [4:en]\n 11 PGS subtitles ripped from 9 files\n\n### API\n\n``` python\nfrom pgsrip import pgsrip, Mkv, Options\nfrom babelfish import Language\n\nmedia = Mkv('/subtitle/path/mymedia.mkv')\noptions = Options(languages={Language('eng')}, overwrite=True, one_per_lang=False)\npgsrip.rip(media, options)\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Rip your PGS subtitles",
"version": "0.1.6",
"split_keywords": [
"video",
"mkv",
"subtitles",
"rip",
"srt",
"pgs",
"sup",
"sub",
"metadata",
"movie",
"episode",
"tv",
"shows",
"series"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "957a34f5ce05cf01dfb327c17ed930e9c693892c4d743748c011d13200552c33",
"md5": "f172c2342af746ec2273516a1aac2d7d",
"sha256": "7d188ce442bdf93d1e6043e68501d1e4a0f9933a415402ee81f58ced5d4ed855"
},
"downloads": -1,
"filename": "pgsrip-0.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f172c2342af746ec2273516a1aac2d7d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1,<4.0.0",
"size": 18611,
"upload_time": "2023-02-05T21:41:29",
"upload_time_iso_8601": "2023-02-05T21:41:29.556708Z",
"url": "https://files.pythonhosted.org/packages/95/7a/34f5ce05cf01dfb327c17ed930e9c693892c4d743748c011d13200552c33/pgsrip-0.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1a079262420ae398055d20f6c72d8d1fd05419854a4acc513b33ff900687436a",
"md5": "d61e4c8ad6a7014c0ac234f71a0a1d81",
"sha256": "265a1254878ef750014ac96b0f0696d3818ba9a0627c6c5fe028b3dc2bc22871"
},
"downloads": -1,
"filename": "pgsrip-0.1.6.tar.gz",
"has_sig": false,
"md5_digest": "d61e4c8ad6a7014c0ac234f71a0a1d81",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1,<4.0.0",
"size": 15597,
"upload_time": "2023-02-05T21:41:30",
"upload_time_iso_8601": "2023-02-05T21:41:30.833149Z",
"url": "https://files.pythonhosted.org/packages/1a/07/9262420ae398055d20f6c72d8d1fd05419854a4acc513b33ff900687436a/pgsrip-0.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-05 21:41:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "ratoaq2",
"github_project": "pgsrip",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pgsrip"
}
JSON
