# SRTranslator
## Install
[PyPI](https://pypi.org/project/srtranslator/)
```bash
pip install srtranslator
```
## Usage in Blender
[tin2tin](https://github.com/tin2tin) has made this [blender addon](https://github.com/tin2tin/import_subtitles). Check it out.
## Usage from script
Import stuff
```python
import os
# SRT File
from srtranslator import SrtFile
# ASS File
from srtranslator import AssFile
from srtranslator.translators.deepl_api import DeeplApi
from srtranslator.translators.deepl_scrap import DeeplTranslator
from srtranslator.translators.translatepy import TranslatePy
from srtranslator.translators.pydeeplx import PyDeepLX
```
Initialize translator. It can be any translator, even your own, check the docs, there are instructions per translator and how to create your own.
```python
translator = DeeplTranslator() # or TranslatePy() or DeeplApi(api_key) or DeepLX()
```
Load, translate and save. For multiple recursive files in folder, check `examples folder`
```python
filepath = "./filepath/to/srt"
# SRT File
sub = SrtFile(filepath)
# ASS File
sub = AssFile(filepath)
# Translate
sub.translate(translator, "en", "es")
# Making the result subtitles prettier
sub.wrap_lines()
sub.save(f"{os.path.splitext(filepath)[0]}_translated.srt")
```
Quit translator
```python
translator.quit()
```
## Usage from GUI
[KryptoST](https://github.com/KryptoST) has made a graphical user interface. You can check it out [here](https://github.com/KryptoST/SRTranslatorGUI)
## Usage command line
```bash
# SRT file
python -m srtranslator ./filepath/to/srt -i SRC_LANG -o DEST_LANG
# ASS file
python -m srtranslator ./filepath/to/ass -i SRC_LANG -o DEST_LANG
```
## Advanced usage
```
usage: __main__.py [-h] [-i SRC_LANG] [-o DEST_LANG] [-v] [-vv] [-s] [-w WRAP_LIMIT] [-t {deepl-scrap,translatepy,deepl-api,pydeeplx}] [--auth AUTH] path
Translate an .STR and .ASS file
positional arguments:
path File to translate
options:
-h, --help show this help message and exit
-i SRC_LANG, --src-lang SRC_LANG
Source language. Default: auto
-o DEST_LANG, --dest-lang DEST_LANG
Destination language. Default: es (spanish)
-v, --verbose Increase output verbosity
-vv, --debug Increase output verbosity for debugging
-s, --show-browser Show browser window
-w WRAP_LIMIT, --wrap-limit WRAP_LIMIT
Number of characters -including spaces- to wrap a line of text. Default: 50
-t {deepl-scrap,translatepy,deepl-api}, --translator {deepl-scrap,translatepy,deepl-api,pydeeplx}
Built-in translator to use
--auth AUTH Api key if needed on translator
--proxies Use proxy by default for pydeeplx
```
Raw data
{
"_id": null,
"home_page": "https://github.com/sinedie/SRTranslator",
"name": "srtranslator",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "python,srt,languages,translator,subtitles",
"author": "EAR",
"author_email": "sinedie@protonmail.com",
"download_url": "https://files.pythonhosted.org/packages/e2/67/583e188c70a83f696bfede145eaae82dc83b3f0a5bac29484ee109c78e7b/srtranslator-0.3.6.tar.gz",
"platform": null,
"description": "# SRTranslator\n\n## Install\n\n[PyPI](https://pypi.org/project/srtranslator/)\n\n```bash\npip install srtranslator\n```\n\n## Usage in Blender\n\n[tin2tin](https://github.com/tin2tin) has made this [blender addon](https://github.com/tin2tin/import_subtitles). Check it out.\n\n## Usage from script\n\nImport stuff\n\n```python\nimport os\n\n# SRT File\nfrom srtranslator import SrtFile\n# ASS File\nfrom srtranslator import AssFile\n\nfrom srtranslator.translators.deepl_api import DeeplApi\nfrom srtranslator.translators.deepl_scrap import DeeplTranslator\nfrom srtranslator.translators.translatepy import TranslatePy\nfrom srtranslator.translators.pydeeplx import PyDeepLX\n```\n\nInitialize translator. It can be any translator, even your own, check the docs, there are instructions per translator and how to create your own.\n\n```python\ntranslator = DeeplTranslator() # or TranslatePy() or DeeplApi(api_key) or DeepLX()\n```\n\nLoad, translate and save. For multiple recursive files in folder, check `examples folder`\n\n```python\nfilepath = \"./filepath/to/srt\"\n\n# SRT File\nsub = SrtFile(filepath)\n# ASS File\nsub = AssFile(filepath)\n\n# Translate\nsub.translate(translator, \"en\", \"es\")\n\n# Making the result subtitles prettier\nsub.wrap_lines()\n\nsub.save(f\"{os.path.splitext(filepath)[0]}_translated.srt\")\n```\n\nQuit translator\n\n```python\ntranslator.quit()\n```\n\n## Usage from GUI\n\n[KryptoST](https://github.com/KryptoST) has made a graphical user interface. You can check it out [here](https://github.com/KryptoST/SRTranslatorGUI)\n\n## Usage command line\n\n```bash\n# SRT file\npython -m srtranslator ./filepath/to/srt -i SRC_LANG -o DEST_LANG\n\n# ASS file\npython -m srtranslator ./filepath/to/ass -i SRC_LANG -o DEST_LANG\n```\n\n## Advanced usage\n\n```\nusage: __main__.py [-h] [-i SRC_LANG] [-o DEST_LANG] [-v] [-vv] [-s] [-w WRAP_LIMIT] [-t {deepl-scrap,translatepy,deepl-api,pydeeplx}] [--auth AUTH] path\n\nTranslate an .STR and .ASS file\n\npositional arguments:\n path File to translate\n\noptions:\n -h, --help show this help message and exit\n -i SRC_LANG, --src-lang SRC_LANG\n Source language. Default: auto\n -o DEST_LANG, --dest-lang DEST_LANG\n Destination language. Default: es (spanish)\n -v, --verbose Increase output verbosity\n -vv, --debug Increase output verbosity for debugging\n -s, --show-browser Show browser window\n -w WRAP_LIMIT, --wrap-limit WRAP_LIMIT\n Number of characters -including spaces- to wrap a line of text. Default: 50\n -t {deepl-scrap,translatepy,deepl-api}, --translator {deepl-scrap,translatepy,deepl-api,pydeeplx}\n Built-in translator to use\n --auth AUTH Api key if needed on translator\n --proxies Use proxy by default for pydeeplx\n```\n\n\n",
"bugtrack_url": null,
"license": "FREE",
"summary": "Traslate a .SRT file using any custom translator",
"version": "0.3.6",
"project_urls": {
"Homepage": "https://github.com/sinedie/SRTranslator"
},
"split_keywords": [
"python",
"srt",
"languages",
"translator",
"subtitles"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "60e03cd52d2ee6ac4a399750b31fa9285dda8bc42974c570a3c42e8ba5e10b01",
"md5": "5c0496ab363fd9b04e1231c29a4776a9",
"sha256": "bf8d3b44839fa460d99f088333239580afdd9100208c25fadc1af692d45a1a90"
},
"downloads": -1,
"filename": "srtranslator-0.3.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5c0496ab363fd9b04e1231c29a4776a9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 15007,
"upload_time": "2023-12-20T14:20:09",
"upload_time_iso_8601": "2023-12-20T14:20:09.087155Z",
"url": "https://files.pythonhosted.org/packages/60/e0/3cd52d2ee6ac4a399750b31fa9285dda8bc42974c570a3c42e8ba5e10b01/srtranslator-0.3.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e267583e188c70a83f696bfede145eaae82dc83b3f0a5bac29484ee109c78e7b",
"md5": "613cf592627323915d53facb2e140f7e",
"sha256": "deb8dc1a0fa7aa3ee2cda11ff6650feba2eaf33232b5fa511e566033c1c1fac2"
},
"downloads": -1,
"filename": "srtranslator-0.3.6.tar.gz",
"has_sig": false,
"md5_digest": "613cf592627323915d53facb2e140f7e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 11752,
"upload_time": "2023-12-20T14:20:48",
"upload_time_iso_8601": "2023-12-20T14:20:48.459477Z",
"url": "https://files.pythonhosted.org/packages/e2/67/583e188c70a83f696bfede145eaae82dc83b3f0a5bac29484ee109c78e7b/srtranslator-0.3.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-20 14:20:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sinedie",
"github_project": "SRTranslator",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "srtranslator"
}
JSON
