detail.localesync.title | POLPROG Skip to content

LocaleSync

LocaleSync

LocaleSync - Auto-Sync & Translate Locale Files

One command to fill the gaps in your translation files.

CLI Developer Tool
4
Commands
265+
Tests
Languages Supported
0
Config Required

About

LocaleSync is an open-source Python CLI tool that scans your project for locale JSON files, detects missing translation keys, and auto-fills them via Google Translate - with full placeholder protection. It supports deeply nested JSON, auto-discovers locale directories, and works with any frontend framework (Angular, React, Vue, plain HTML). Run it locally during development or plug it into CI/CD pipelines for automated checks. Four commands cover every workflow: scan, check, sync, and translate.

Key Features

01

Auto-Discovery

Point it at your project root and LocaleSync finds locale directories automatically - no config files needed.

02

Google Translate Integration

Translates missing keys via the free Google Translate API. Handles rate limits gracefully with automatic retries.

03

Placeholder Protection

Safeguards {{variables}}, {0}, %s, and other interpolation tokens so they survive translation intact.

04

Deep Nested JSON

Handles arbitrarily nested locale structures - compares at every depth, preserves hierarchy on write.

05

Rich Progress Bar

Live progress with ETA, key counter, elapsed time, and language tracker. Cancel anytime with Ctrl+C.

06

CI/CD Ready

Non-interactive mode with proper exit codes. Use check in CI to block PRs with missing translations.

07

Framework Agnostic

Works with Angular, React, Vue, Svelte, plain HTML, or any project that uses JSON locale files.

08

Extensible Architecture

Clean, layered design with pluggable translation providers, file formats, and sync strategies. MIT licensed.

Privacy & Security

Your data stays on your device. Always.

Local File Processing No Telemetry No Account Required Open Source (MIT) Opt-in Translation Only

Product Info

  • Commandsscan, check, sync, translate
  • Python3.12+
  • TranslationGoogle Translate
  • File FormatJSON (nested)
  • PublisherPOLPROG
  • LicenseMIT
  • PriceFree
  • Repository LocaleSync
  • Open issues 0
  • Last update