lancedelgardo/deepl-i18n

deepl-i18n is a command line tool that translates the JSON, YAML, and other localization files used by apps into multiple languages, using the DeepL translation API. It is an unofficial project, not affiliated with DeepL SE. You point it at a file in your source language, list the languages you want as output, and it fills in only the keys that are missing, leaving existing translations untouched and removing keys that are no longer needed. The tool is careful about not wasting your translation quota. Identical strings that repeat across your file, like the word OK or Cancel, are only sent to DeepL once per run and then reused everywhere they appear, so you are not billed twice for the same text. It also protects placeholders such as double curly brace variables from being mangled or accidentally merged into surrounding words during translation, and checks afterward that they survived intact. The placeholder pattern is configurable if your project uses a different style like percent s or numbered braces. Beyond plain JSON, it understands nested YAML files, flat Java properties files, iOS strings files, Flutter ARB files, Android XML resources, and CSV, detecting the format automatically from the file extension or letting you force one. You can set DeepL's formality level, pass a short context description so DeepL picks better terminology, and choose between a quality optimized or latency optimized translation model. Before spending any quota, a dry run shows exactly how many keys and characters would be translated and whether that fits inside DeepL's free tier of 500,000 characters a month, without needing an API key at all. There is also a watch mode that retranslates automatically whenever your source file changes, and a check command meant for continuous integration that validates existing translations and placeholder integrity, exiting with an error code if anything is broken. The only setup required is Python 3.10 or later, a DeepL API key supplied through an environment variable or a local file, and the deepl package, which is the tool's only dependency.