A Batch Subtitle Translator for SRT Files built with Node. See readme.md for usage instructions.
npm install sub-trans-srtš Sub-Trans-SRT v1.4.1
A Batch Subtitle Translator compatible with SRT files.
A queue of lines to be translated are extracted from each file and translated via a translation API. This process is repeated through a single file. When a file is complete, the next file begins.
āļø Currently Supported Translation API:
-Yandex Translate ($75 Free Credit w/ Signup)
-LibreTranslate local (ArgosTranslate/NMT; completely free)
-Google Translate ($300-400 Free Credit w/ Signup)
āļø Future Supported Translation API:
-Azure Translate
-NLP Translate
ā ļø You will need an API Key from one of these services to proceed with the translation, unless you are running LibreTranslate locally.
š» Usage:
The package can be used via npx by calling the following command:
npx sub-trans-srt start --dir='YOUR_DIRECTORY' --out='YOUR_DIRECTORY' --o=originLanguage --d=destinationLanguage --key='YOUR_API_KEY' --service=yandex --style=chooseYourStyle
OR:
npm run start -- --dir='YOUR_DIRECTORY' --out='YOUR_DIRECTORY' --o=originLanguage --d=destinationLanguage --key='YOUR_API_KEY' --service=yandex --style=chooseYourStyle
start - this runs the start script, which executes the batch translation.
--dir='' - this is the directory from your terminal to a folder which contains only the SRT files to be translated
--out='' - this is the directory from your terminal to a folder you wish to output the files into
--o='' - this is the 2/3-letter country code available from the list in the LanguageCodes.txt file in this directory.
--d='' - this is the 2/3-letter country code available from the list in the LanguageCodes.txt file in this directory.
--key='' - this is your API Key as a string. Yandex Translate (easy to create API key), Google Translate (create API key in Gcloud) are currently supported. If using LibreTranslate, you can skip this, or write 'na'.
--service='' - Yandex Translate, LibreTranslate and Google Translate are currently supported in version 1.3.0, and should be selected with a string 'yandex', 'libre', or 'google'. Service 'libre' assumes server is located at 127.0.0.1:5000.
--style='' - two styles are available, 'add' and 'swap'. Add inserts the translated line below its untranslated line, whereas swap removes the untranslated line and replaces it with the translated line.
š±ļø Example of Command Line Usage:
npx sub-trans-srt start --dir=".\inDir\" --out=".\output\" --o=ru --d=en --key="REDACTED" --service=yandex --style=add
npx sub-trans-srt start --dir=".\inDir\" --out=".\output\" --o=ru --d=en --service=libre --style=add
npm run start -- --dir='.\origin\' --out='.\dest\' --o=ru --d=fi --key='---------REDACTED------------' --service=google --style=swap
npm run start -- --dir='.\origin\' --out='.\dest2\' --o=fi --d=ru --key='------------------------------REDACTED------------------------------------' --service=yandex --style=add
ā ļø Files will be output to the folder specified. An Error may occur if the folders are not already in existence.
š½ Sub-Trans-SRT can also be run without arugments by modifying the default values present in sub-trans-srt.js, and running "node sub-trans-srt.js".
š¤ Programmatically, the module can be run via asynchronous function. A sample implementation is attached in the file "sample.js".
š Bug Fixes:
-Support implemented for Simplified Chinese, Korean, Japanese (katakana, hiragana, hankaku, zenkaku). Translation batches are now smaller and more frequent.