Core Translator CLI

Command-line interface for the Core Translator service. Translate iOS strings, PO files, browser extensions, and more.

Installation

``bash
npm install -g core-translator-cli
`

Or use directly with npx:

`bash
npx core-translator-cli --help
`

Configuration

Set your authentication token and backend endpoint:

`bash


Using environment variables

export CORE_TRANSLATOR_TOKEN="your-token-here"
export CORE_TRANSLATOR_BACKEND_ENDPOINT="https://api.example.com"

Or using the config command

core-translator config --token YOUR_TOKEN --endpoint https://api.example.com
`

Usage

$3

`bash
core-translator text --text "Hello World" -t zh-Hans
`

$3

`bash
core-translator xcstrings ./Localizable.xcstrings -t ja
`

$3

`bash


Single PO file

core-translator po ./messages.po -t fr

Multiple PO files using glob pattern (automatically detects language from filename)

core-translator po "src/locales/*.po"

With custom concurrency

core-translator po "src/locales/*.po" --concurrency 8

Disable automatic language extraction from filename

core-translator po "src/locales/*.po" --no-extract-language -t fr
`

$3

`bash
core-translator browser-ext ./_locales/en/messages.json -t es -o ./_locales/es/messages.json
`

$3

`bash
core-translator formatjs "./locales/*.json" --target_language fr
`

$3

`bash
core-translator rails-yaml --source config/locales/en.yml --target config/locales/ja.yml
`

$3

`bash
core-translator xcode-strings ./en.lproj/Localizable.strings -t es
`

$3

`bash
core-translator single-file ./README.md --target_language zh-Hans -o ./README.zh.md
`

Commands

- text - Translate a single text string
- xcstrings - Translate iOS .xcstrings localization files
- po - Translate GNU gettext .po files (supports glob patterns for multiple files)
- browser-ext - Translate browser extension _locales JSON files
- formatjs - Translate FormatJS JSON files
- rails-yaml - Translate Rails i18n YAML files
- xcode-strings - Translate Xcode .strings files
- single-file - Translate a single text file
- config - Configure API credentials

Options

All commands support these common options:

- -t, --target-language - Target language code (required)
- -s, --source-language - Source language code (default: en)
- -a, --app-name - Application name for context
- --endpoint - Override backend endpoint
- --token - Override authentication token
- -v, --verbose - Enable verbose logging

Supported Languages

- ja, ja-JP - Japanese
- ko, ko-KR - Korean
- zh-Hans, zh-CN - Chinese (Simplified)
- zh-Hant, zh-TW - Chinese (Traditional)
- zh-HK - Chinese (Hong Kong)
- de, de-DE - German
- fr, fr-FR - French
- it - Italian
- es, es-ES, es-MX - Spanish
- pt, pt-BR, pt-PT - Portuguese
- en, en-US, en-GB` - English
- And many more...

License

MIT