Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

strsync - Automatically translate and synchronize localizable resource files from defined base language for Xcode.

Project Description

Automatically translate and synchronize ‘.strings’ files from defined base language.

The basic concept of this tool is simple file name based one-way synchronizer. While the actual translation work, My biggest desire was to just fill an empty strings easily. In a normal project, automatic translation is sufficient. Because They are always simple sentences. Yes, No, Do it, Not agree, etc..

If you are running, other localized resources will have exactly the same key with automatically translated strings. Of course, String on the key that already exists will not be modified at all.



pip install strsync

Update Python SSL packages if needed

this is not required for python-2.7.9+

pip install requests[security]


Naturally, this tool follow standard ISO639 1~2 codes or apple’s official document or csv file

usage: strsync    [-h] [-b BASE_LANG_NAME]
                   [-x [EXCLUDING_LANG_NAMES ...]] -c
                   CLIENT_ID -s CLIENT_SECRET
                   [-f [FORCE_TRANSLATE_KEYS ...]]
                   [target path]

Automatically translate and synchronize .strings files from defined base

positional arguments:
  target path           Target localizable resource path. (root path of
                        Base.lproj, default=./)

optional arguments:
  -h, --help            show this help message and exit
  -b BASE_LANG_NAME, --base-lang-name BASE_LANG_NAME
                        A base(or source) localizable resource
                        name.(default='Base'), (e.g. "Base" via 'Base.lproj',
                        "en" via 'en.lproj')
  -x [EXCLUDING_LANG_NAMES ...], --excluding-lang-names [EXCLUDING_LANG_NAMES ...]
                        A localizable resource name that you want to exclude.
                        (e.g. "Base" via 'Base.lproj', "en" via 'en.lproj')
  -c CLIENT_ID, --client-id CLIENT_ID
                        Client ID for MS Translation API
  -s CLIENT_SECRET, --client-secret CLIENT_SECRET
                        Client Secret key for MS Translation API
  -f [FORCE_TRANSLATE_KEYS ...], --force-translate-keys [FORCE_TRANSLATE_KEYS ...]
                        Keys in the strings to update and translate by force.

Examples to use

$ strsync -c clien_idXXXX -s clien_secretXXXX

Define specific path you want.

$ strsync ./myXcodeProj/Resources/Localizations -c clien_idXXXX -s clien_secretXXXX

Excluding japanese, spanish, finnish

$ strsync ./myXcodeProj/Resources/Localizations -c clien_idXXXX -s clien_secretXXXX -x ja es fi

Forcefully translate and update by specific keys you want.

$ strsync -c clien_idXXXX -s clien_secretXXXX -f Common.OK Common.Undo

Forcefully translate and update by specific keys you want.

$ strsync -c clien_idXXXX -s clien_secretXXXX -f   (input nothing.)

When you want to accept the values in the ‘Base’.

$ strsync -c clien_idXXXX -s clien_secretXXXX -fb autoenhance flashmode

"flashmode" = "وضع الفلاش";
"" = "السيارات";
"flashmode.on" = "على";
"autoenhance" = "تعزيز السيارات";

"flashmode" = "Flash Mode";
"" = "السيارات";
"flashmode.on" = "على";
"autoenhance" = "Auto-Enhance";
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
strsync-1.1.3-py2-none-any.whl (21.2 kB) Copy SHA256 Checksum SHA256 py2 Wheel Apr 26, 2017
strsync-1.1.3.tar.gz (21.8 kB) Copy SHA256 Checksum SHA256 Source Apr 26, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting