Locale.CLI
0.0.3
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet tool install --global Locale.CLI --version 0.0.3
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
dotnet tool install --local Locale.CLI --version 0.0.3
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Locale.CLI&version=0.0.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
nuke :add-package Locale.CLI --version 0.0.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Locale.CLI
A cross-platform command-line tool for multi-format localization management with auto-translation support.
Installation
dotnet tool install -g Locale.CLI
Commands
locale scan - Scan for Translation Gaps
Compare localization files across cultures, detect missing/orphan keys and empty values.
locale scan ./locales --base en --targets tr,de
locale diff - Compare Two Files
Compare two localization files with placeholder mismatch detection.
locale diff en.json tr.json
locale check - Validate Against Rules
Validate files against configurable rules with CI exit codes.
locale check ./locales --rules no-empty-values,no-duplicate-keys --ci
locale convert - Transform Between Formats
Convert localization files between different formats.
locale convert en.json en.yaml
locale generate - Create Skeleton Files
Generate skeleton target files from a base language.
locale generate tr --from en --in ./locales --out ./locales
locale watch - Monitor for Changes
Watch localization files for changes and auto-run scan/check.
locale watch ./locales --base en --mode scan
locale translate - Auto-Translate
Automatically translate using external APIs.
# Google Translate (free, no API key)
locale translate tr --from en --in ./locales --provider google
# DeepL (requires API key)
locale translate de --from en --in ./locales --provider deepl --api-key YOUR_KEY
# OpenAI ChatGPT
locale translate tr --from en --in ./locales --provider openai --api-key YOUR_KEY
# Local Ollama
locale translate tr --from en --in ./locales --provider ollama --model llama3.2
Translation Providers
| Provider | API Key Required | Notes |
|---|---|---|
| No | Uses free unofficial API | |
| DeepL | Yes | High quality translations |
| Bing | Yes | Microsoft Translator |
| Yandex | Yes | Good for Slavic languages |
| LibreTranslate | Optional | Open source, self-hostable |
| OpenAI | Yes | ChatGPT (gpt-4o-mini default) |
| Claude | Yes | Anthropic Claude 3 |
| Gemini | Yes | Google AI |
| Azure OpenAI | Yes | Enterprise Azure deployment |
| Ollama | No | Local LLM (llama3.2 default) |
Supported Formats
JSON, YAML, RESX, PO/Gettext, XLIFF, SRT, VTT, CSV, i18next JSON, Fluent FTL, and VB resources.
License
MIT License - see LICENSE for details.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
This package has no dependencies.