CLI Tool - Version History

This page documents all changes to the GetTranslated CLI tool. For installation instructions and usage guide, see the CLI Quick Start Guide.

The CLI follows Semantic Versioning:

• MAJOR (X.0.0): Breaking changes
• MINOR (0.X.0): New features, backward compatible
• PATCH (0.0.X): Bug fixes, backward compatible

Version 1.6.1 - August 13, 2026

Release Date: August 13, 2026

Type: Patch Release - Download safety guard

Added

• Download safety guard — download/sync now refuse to overwrite an existing local translation file with an empty or corrupt/unparseable download (a truncated or failed transfer), instead of silently replacing your translations with a broken file. Pass --force to overwrite anyway.
• This never blocks a legitimate change: a smaller-but-valid download (for example after you delete strings) is written normally. Combined with the server-side fix that prevents an interrupted sync from composing a short file, a sync never silently loses keys.

Documentation

• --ref caveats: a new branch starts empty on the server — run a full sync (not a bare download) the first time. Don't pass your default branch's name from a feature branch, or you'll write your in-progress changes onto the shared default branch.

View on PyPI →

Version 1.6.0 - August 13, 2026

Release Date: August 13, 2026

Type: Minor Release - Branch-aware sync & update notifications

Added

• Branch-aware sync
  • upload/download/translate/validate automatically detect your current git branch and sync that branch's version of your files, so teammates on different branches don't overwrite each other on the server
  • Override auto-detection with --ref <branch> or the GETTRANSLATED_REF environment variable (useful in CI, which often checks out a detached HEAD); common CI branch variables are used as a fallback
  • Backward compatible: omit a branch to sync the project's default branch
• Update notifications — the CLI prints an upgrade notice when a newer version is available, and sends its version in the User-Agent header

Removed

• The grammar command — grammar checking now runs automatically as part of the translate/sync pipeline, so a separate command is no longer needed

Changed

• The API key is redacted in --verbose output
• translate/sync now exit non-zero when a file upload fails, instead of reporting success
• Non-interactive / CI runs no longer block on prompts — they take a safe default
• Downloaded files are written atomically as the server's exact bytes, and transient network errors on reads are retried

View on PyPI →

Version 1.5.0 - August 4, 2026

Release Date: August 4, 2026

Type: Minor Release - Flutter support & configurable directories

Added

• Flutter (App Resource Bundle / .arb) support
  • sync/upload/download discover *.arb files — one file per locale (app_en.arb → app_es.arb), matching both the conventional app_XX.arb prefix and a bare XX.arb, under lib/l10n/ and other common locations
  • init detects languages from a project's .arb files, preferring each file's @@locale and falling back to the filename's locale suffix
  • Works alongside the existing Android / iOS / React Native formats; requires a Flutter project on the server
• Configurable localization directories (React Native & Flutter)
  • init can record custom localization directory(ies) so upload/download/sync find files outside the default locations
  • Configured directories are additive to the built-in search locations, so enabling them never stops finding files that were found before; enter none to clear them
  • .gettranslated gains an optional JSON form ({"key": "...", "dirs": [...]}), written only when custom directories are set — otherwise it stays a bare API-key string so teammates on older CLI versions keep working

View on PyPI →

Version 1.4.0 - August 4, 2026

Release Date: August 4, 2026

Type: Minor Release - Apple String Catalog support

Added

• Apple String Catalog (.xcstrings) support for iOS projects
  • sync/upload/download discover *.xcstrings files (Xcode 15's default). A String Catalog is a single multi-language file, so the whole catalog is uploaded and written back with all target languages merged in — no per-language .lproj layout to manage
  • init detects languages from a catalog's contents (source language + localizations), not just .lproj directories
  • Works alongside the existing .strings/.stringsdict formats

View on PyPI →

Version 1.3.1 - January 20, 2025

Release Date: January 20, 2025

Type: Patch Release - Performance Optimization

Changed

• Optimized React Native file search by removing redundant directory entries
  • Improved search efficiency while maintaining full coverage of common project structures
  • The recursive search for locales and i18n now automatically covers nested paths like src/locales and src/i18n

View on PyPI →

Version 1.3.0 - December 11, 2025

Release Date: December 11, 2025

Type: Minor Release - New Validate Command

Added

• New validate command:
  • Runs validation on all project translations, if any are pending validation
  • When --force is specified, the command re-validates the most recent project source files as well as all project translations
  • Provides summary of re-validated files and any validation issues found

View on PyPI →

Version 1.2.0 - December 8, 2025

Release Date: December 8, 2025

Type: Minor Release - New Init Command & Improvements

Added

• New init command for easy project setup:
  • Guides users through API key configuration with masked input
  • Validates API key by connecting to GetTranslated project
  • Displays project information (name, platform, base language, target languages)
  • Optionally saves API key to .gettranslated file for future use
  • Provides helpful links to project settings when languages aren't configured

Changed

• Updated API key resolution precedence order: command line → .gettranslated file → environment variable
  • Project-specific config files now take precedence over global environment variables
  • Better support for multi-project workflows
• Improved error messages for "No files found" scenarios:
  • Added "Have you specified the correct directory?" prompt
  • Enhanced React Native error messages with prominent documentation links
  • Platform-specific file location guidance with troubleshooting links
• Enhanced documentation:
  • Added comprehensive init command documentation
  • Updated quick start guide to recommend init for first-time setup
  • Clarified when to use each API key configuration method (local dev vs CI/CD)
  • Removed manual echo instructions in favor of init command

Improved

• Better user experience for first-time setup with guided init workflow
• More secure API key input using masked prompts
• Clearer separation between local development and CI/CD workflows

View on PyPI →

Version 1.1.1 - December 3, 2025

Release Date: December 3, 2025

Type: Documentation Update

Changed

• Updated README with comprehensive documentation:
  • Added Server API Key clarification and requirements
  • Documented first sync workflow and language detection
  • Added validation section with examples
  • Expanded troubleshooting guide with detailed error scenarios
  • Added error handling documentation
  • Documented all command options including --bypass-validation and --version

View on PyPI →

Version 1.1.0 - December 3, 2025

Release Date: December 3, 2025

Type: Minor Release - Error Handling & Improvements

Added

• Comprehensive error handling with helpful user messages
• Error messages include links to relevant documentation sections
• Unified exception handling system for consistent error reporting
• Timeouts for different operation types
• Better 404 error handling for missing translations with actionable guidance

Changed

• Improved authentication error messages (403) with links to configuration guide
• Enhanced project not found error messages (404) with troubleshooting steps
• Translation file not found errors now return 404 (not 500) with helpful messages

Fixed

• Bug fixes and improvements

Improved

• Code organization and maintainability
• User-facing error messages with clear next steps
• Documentation links in error messages

View on PyPI →

Version 1.0.2 - 2025

Release Date: 2025

Type: Patch Release

Changed

• Initial public release improvements

View on PyPI →

Version 1.0.1 - 2025

Release Date: 2025

Type: Patch Release

Changed

• Bug fixes and improvements

View on PyPI →

Version 1.0.0 - 2025

Release Date: 2025

Type: Initial Release

Added

• Initial release of GetTranslated CLI
• Support for Android, iOS, and React Native platforms
• Commands: upload, download, translate, sync, grammar
• API key configuration via command line, environment variable, or config file
• Automatic language file detection
• First sync workflow with language detection and warnings
• Validation error reporting
• Force upload option
• Verbose output mode
• Custom server URL support

View on PyPI →

Installation

To install or upgrade to the latest version:

pip install --upgrade gettranslated-cli

To install a specific version:

pip install gettranslated-cli==1.3.1

Reporting Issues

Found a bug or have a feature request? Please contact us at [email protected] or visit our troubleshooting guide.