- Contact with me on Twitter to advertise your project on jsontt cli
This package will provide you to translate your JSON/YAML files or JSON objects into different languages FREE.
Translation Module | Support | FREE |
---|---|---|
Google Translate | โ | โ
FREE |
Google Translate 2 | โ | โ
FREE |
Microsoft Bing Translate | โ | โ
FREE |
Libre Translate | โ | โ
FREE |
Argos Translate | โ | โ
FREE |
DeepL Translate | โ | require API KEY (DEEPL_API_KEY as env) |
gpt-4o | โ | require API KEY (OPENAI_API_KEY as env) |
gpt-3.5-turbo | โ | require API KEY (OPENAI_API_KEY as env) |
gpt-4 | โ | require API KEY (OPENAI_API_KEY as env) |
gpt-4o-mini | โ | require API KEY (OPENAI_API_KEY as env) |
Translation Module | Support | FREE |
---|---|---|
Google Translate | โ | โ
FREE |
Google Translate 2 | โ | โ |
Microsoft Bing Translate | โ | โ |
Libre Translate | โ | โ |
Argos Translate | โ | โ |
DeepL Translate | โ | โ |
gpt-4o | โ | โ |
gpt-3.5-turbo | โ | โ |
gpt-4 | โ | โ |
gpt-4o-mini | โ | โ |
Browser support will come soon...
npm i @parvineyvazov/json-translator
- OR you can install it globally (in case of using CLI)
npm i -g @parvineyvazov/json-translator
jsontt <your/path/to/file.json>
or
jsontt <your/path/to/file.yaml/yml>
[path]
: Required JSON/YAML file path<your/path/to/file.json>
[path]
: optional proxy list txt file path<your/path/to/proxy_list.txt>
-V, --version output the version number
-m, --module <Module> specify translation module
-f, --from <Language> from language
-t, --to <Languages...> to translates
-n, --name <string> optional โต | output filename
-fb, --fallback <string> optional โต | fallback logic,
try other translation modules on fail | yes, no | default: no
-cl, --concurrencylimit <number> optional โต | set max concurrency limit
(higher faster, but easy to get banned) | default: 3
-h, --help display help for command
Translate a JSON file using Google Translate:
jsontt <your/path/to/file.json> --module google --from en --to ar fr zh-CN
- with output name
jsontt <your/path/to/file.json> --module google --from en --to ar fr zh-CN --name myFiles
- with fallback logic (try other possible translation modules on fail)
jsontt <your/path/to/file.json> --module google --from en --to ar fr zh-CN --name myFiles --fallback yes
- set concurrency limit (higher faster, but easy to get banned | default: 3)
jsontt <your/path/to/file.json> --module google --from en --to ar fr zh-CN --name myFiles --fallback yes --concurrencylimit 10
- translate (json/yaml)
jsontt file.json
jsontt folder/file.json
jsontt "folder\file.json"
jsontt "C:\folder1\folder\en.json"
- with proxy (only Google Translate module)
jsontt file.json proxy.txt
Result will be in the same folder as the original JSON/YAML file.
- help
jsontt -h
jsontt --help
- Import the library to your code.
For JavaScript
const translator = require('@parvineyvazov/json-translator');
For TypeScript:
import * as translator from '@parvineyvazov/json-translator';
// Let`s translate `Home sweet home!` string from English to Chinese
const my_str = await translator.translateWord(
'Home sweet home!',
translator.languages.English,
translator.languages.Chinese_Simplified
);
// my_str: ๅฎถ๏ผ็่็ๅฎถ๏ผ
- Import the library to your code
For JavaScript
const translator = require('@parvineyvazov/json-translator');
For TypeScript:
import * as translator from '@parvineyvazov/json-translator';
/*
Let`s translate our deep object from English to Spanish
*/
const en_lang: translator.translatedObject = {
login: {
title: 'Login {{name}}',
email: 'Please, enter your email',
failure: 'Failed',
},
homepage: {
welcoming: 'Welcome!',
title: 'Live long, live healthily!',
},
profile: {
edit_screen: {
edit: 'Edit your informations',
edit_age: 'Edit your age',
number_editor: [
{
title: 'Edit number 1',
button: 'Edit 1',
},
{
title: 'Edit number 2',
button: 'Edit 2',
},
],
},
},
};
/*
FOR JavaScript don`t use translator.translatedObject (No need to remark its type)
*/
let es_lang = await translator.translateObject(
en_lang,
translator.languages.English,
translator.languages.Spanish
);
/*
es_lang:
{
"login": {
"title": "Acceso {{name}}",
"email": "Por favor introduzca su correo electrรณnico",
"failure": "Fallida"
},
"homepage": {
"welcoming": "ยกBienvenidas!",
"title": "ยกVive mucho tiempo, vivo saludable!"
},
"profile": {
"edit_screen": {
"edit": "Edita tus informaciones",
"edit_age": "Editar tu edad",
"number_editor": [
{
"title": "Editar nรบmero 1",
"button": "Editar 1"
},
{
"title": "Editar nรบmero 2",
"button": "Editar 2"
}
]
}
}
}
*/
- Import the library to your code
For JavaScript
const translator = require('@parvineyvazov/json-translator');
For TypeScript:
import * as translator from '@parvineyvazov/json-translator';
/*
Let`s translate our object from English to French, Georgian and Japanese in the same time:
*/
const en_lang: translator.translatedObject = {
login: {
title: 'Login',
email: 'Please, enter your email',
failure: 'Failed',
},
edit_screen: {
edit: 'Edit your informations',
number_editor: [
{
title: 'Edit number 1',
button: 'Edit 1',
},
],
},
};
/*
FOR JavaScript don`t use translator.translatedObject (No need to remark its type)
*/
const [french, georgian, japanese] = (await translator.translateObject(
en_lang,
translator.languages.Automatic,
[
translator.languages.French,
translator.languages.Georgian,
translator.languages.Japanese,
]
)) as Array<translator.translatedObject>; // FOR JAVASCRIPT YOU DO NOT NEED TO SPECIFY THE TYPE
/*
french:
{
"login": {
"title": "Connexion",
"email": "S'il vous plaรฎt, entrez votre email",
"failure": "Manquรฉe"
},
"edit_screen": {
"edit": "Modifier vos informations",
"number_editor": [
{
"title": "Modifier le numรฉro 1",
"button": "รditer 1"
}
]
}
}
georgian:
{
"login": {
"title": "แฒจแแกแแแ",
"email": "แแแฎแแแ, แจแแแงแแแแแ แแฅแแแแ แแ",
"failure": "แแชแแแแแแ"
},
"edit_screen": {
"edit": "แแฅแแแแ แแแคแแ แแแชแแแแ แ แแแแฅแขแแ แแแ",
"number_editor": [
{
"title": "แ แแแแฅแขแแ แแแแก แแแแแ แ 1",
"button": "แ แแแแฅแขแแ แแแ 1"
}
]
}
}
japanese:
{
"login": {
"title": "ใญใฐใคใณ",
"email": "ใใชใใฎใกใผใซใขใใฌในใๅ
ฅๅใใฆใใ ใใ",
"failure": "ๅคฑๆใใ"
},
"edit_screen": {
"edit": "ใใชใใฎๆ
ๅ ฑใ็ทจ้ใใพใ",
"number_editor": [
{
"title": "็ชๅท1ใ็ทจ้ใใพใ",
"button": "็ทจ้1ใ็ทจ้ใใพใ"
}
]
}
}
*/
- Import the library to your code.
For JavaScript
const translator = require('@parvineyvazov/json-translator');
For TypeScript:
import * as translator from '@parvineyvazov/json-translator';
/*
Let`s translate our json file into another language and save it into the same folder of en.json
*/
let path = 'C:/files/en.json'; // PATH OF YOUR JSON FILE (includes file name)
await translator.translateFile(path, translator.languages.English, [
translator.languages.German,
]);
โโ files
โโโ en.json
โโโ de.json
- Import the library to your code.
For JavaScript
const translator = require('@parvineyvazov/json-translator');
For TypeScript:
import * as translator from '@parvineyvazov/json-translator';
/*
Let`s translate our json file into multiple languages and save them into the same folder of en.json
*/
let path = 'C:/files/en.json'; // PATH OF YOUR JSON FILE (includes file name)
await translator.translateFile(path, translator.languages.English, [
translator.languages.Cebuano,
translator.languages.French,
translator.languages.German,
translator.languages.Hungarian,
translator.languages.Japanese,
]);
โโ files
โโโ en.json
โโโ ceb.json
โโโ fr.json
โโโ de.json
โโโ hu.json
โโโ ja.json
To ignore words on translation use {{word}}
OR {word}
style on your object.
{
"one": "Welcome {{name}}",
"two": "Welcome {name}",
"three": "I am {name} {{surname}}"
}
...translating to spanish
{
"one": "Bienvenido {{name}}",
"two": "Bienvenido {name}",
"three": "Soy {name} {{surname}}"
}
-
jsontt also ignores the
URL
in the text which means sometimes translations ruin the URL in the given string while translating that string. It prevents such cases by ignoring URLs in the string while translating.- You don't especially need to do anything for it, it ignores them automatically.
{
"text": "this is a puppy https://shorturl.at/lvPY5"
}
...translating to german
{
"text": "das ist ein welpe https://shorturl.at/lvPY5"
}
- Clone it
git clone https://github.com/mololab/json-translator.git
- Install dependencies (with using yarn - install yarn if you don't have)
yarn
-
Show the magic:
-
Update CLI
Go to file
src/cli/cli.ts
-
Update translation
Go to file
src/modules/functions.ts
-
Update JSON operations(deep dive, send translation request)
Go to file
src/core/json_object.ts
-
Update JSON file read/write operations
Go to file
src/core/json_file.ts
-
Update ignoring values in translation (map/unmap)
Go to file
src/core/ignorer.ts
-
-
Check CLI locally
For checking CLI locally we need to link
the package using npm
npm link
Or you can run the whole steps using make
make run-only-cli
Make sure your terminal has admin access while running these commands to prevent any access issues.
โ๏ธ Translate a word | sentence
- for JSON objects
โ๏ธ Translate JSON object
โ๏ธ Translate deep JSON object
โ๏ธ Multi language translate for JSON object
- Translate JSON object with extracting OR filtering some of its fields
- for JSON files
โ๏ธ Translate JSON file
โ๏ธ Translate deep JSON file
โ๏ธ Multi language translate for JSON file
- Translate JSON file with extracting OR filtering some of its fields
- General
โ๏ธ CLI support
โ๏ธ Safe translation (Checking undefined, long, or empty values)
โ๏ธ Queue support for big translations
โ๏ธ Informing the user about the translation process (number of completed ones, the total number of lines and etc.)
โ๏ธ Ignore value words in translation (such as ignore {{name}} OR {name} on translation)
โ๏ธ Libre Translate option (CLI)
โ๏ธ Argos Translate option (CLI)
โ๏ธ Bing Translate option (CLI)
โ๏ธ Ignore URL translation on given string
โ๏ธ CLI options for langs & source selection
โ๏ธ Define output file names on cli (optional command for cli)
โ๏ธ YAML file Translate
โ๏ธ Fallback Translation (try new module on fail)
โ๏ธ Can set concurrency limit manually
-
Libre Translate option (in code package)
-
Argos Translate option (in code package)
-
Bing Translate option (in code package)
โ๏ธ ChatGPT support
-
Sync translation
-
Browser support
-
Translation Option for own LibreTranslate instance
-
Make "--" dynamic adjustable (placeholder of not translated ones).
@parvineyvazov/json-translator will be available under the MIT license.