Json-locale-translator NPM

JSON Locale Translator

A command-line tool to translate JSON-based locale files using Google Translate.

Features

🔄 Translates JSON locale files while preserving structure
🌐 Supports multiple languages
🎯 Handles nested JSON objects
💪 Preserves original keys
🎨 Colorful console output for better visibility

Installation

# Using npm
npm install -g json-locale-translator

# Using locally
npm install json-locale-translator

# Using yarn
yarn add -g json-locale-translator

# Using locally yarn
yarn add json-locale-translator

Usage

Using globally

Show help

json-locale-translator --help

Translate a file

json-locale-translator -s example/en.json -f en -t es

Interactive mode

json-locale-translator -i

Using locally

Then add scripts to your project's package.json:

"scripts": {
 "translate": "json-locale-translator",
    "translate:es": "json-locale-translator -s example/en.json -f en -t es",
    "translate:fr": "json-locale-translator -s example/en.json -f en -t fr",
    "translate:interactive": "json-locale-translator -i"
  }

npm run translate

use with npx

npx json-locale-translator -s example/en.json -f en -t es

Basic Usage (with global installation)

Create a Source File

mkdir locales && echo {} > locales\en.json

Interactive Translation (Recommended)

json-locale-translator -s example/en.json -f en -t es

Sample Input/Output

Input (en.json):

{
  "welcome": "Welcome to our application",
  "navigation": {
    "home": "Home",
    "about": "About",
    "contact": "Contact"
  }
}

Output (es.json):

{
  "welcome": "Bienvenido a nuestra aplicación",
  "navigation": {
    "home": "Inicio",
    "about": "Acerca de",
    "contact": "Contacto"
  }
}

Supported Languages

The tool supports all languages available in Google Translate. Some common language codes:

en - English
es - Spanish
fr - French
de - German
it - Italian
pt - Portuguese
ru - Russian
zh - Chinese
ja - Japanese
ko - Korean

Full list of language codes

Development

# Clone the repository
git clone https://github.com/MhamedEl-shahawy/json-locale-translator.git

# Install dependencies
cd json-locale-translator
npm install

# Link for local development
npm link

Project Structure

json-locale-translator/
├── src/
│   └── index.js          # Main CLI tool
├── example/
│   ├── en.json          # Source example
│   └── es.json          # Translated example
├── scripts/
│   └── batch-translate.js # Batch translation script
├── package.json
└── README.md