crowdin auto-translate

Description

Auto-translate files via Machine Translation (MT), Translation Memory (TM), or AI

Synopsis

crowdin auto-translate [OPTIONS]

Options

-l, --language=…
Languages to which auto-translation should be applied. Can be specified multiple times. Default: all (default: all)

-e, --exclude-language=…
Languages to exclude from auto-translation. Can be specified multiple times

--file=…
Path to the file in the Crowdin project. Can be specified multiple times

--method=…
Defines auto-translation method. Supported values: mt, tm, ai

--engine-id=…
Machine Translation engine Identifier

-b, --branch=…
Specify branch name (default: "none")

--directory=…
Path to the directory in Crowdin

--auto-approve-option=…
Defines which translations added by TM auto-translation should be auto-approved. Supported values: all, except-auto-substituted, perfect-match-only. Default: none

--duplicate-translations
Adds translations even if the same translation already exists

--no-duplicate-translations
Skips adding a translation if the same one already exists

--skip-approved-translations
Skips strings that already have an approved translation

--scope=…
Defines strings that should be auto-translated. Default: untranslated (choices: "untranslated", "translated", "all")

--priority=…
Defines the auto-translation priority. Default: normal (choices: "low", "normal", "high")

--translation-modified-before=…
Re-translates strings only if their translations were modified before the given date-time (e.g. 2024-01-01T00:00:00Z)

--replace-translations-option=…
Defines whether to replace existing translations. Default: none (choices: "none", "auto-translated", "all")

--reset-approval-status
Removes approval from existing translations that get replaced

--translate-with-perfect-match-only
Applies auto-translation only for the strings with perfect match

--no-translate-with-perfect-match-only
Applies auto-translation regardless of perfect match

--label=…
Filter strings to auto-translate by labels. Can be specified multiple times

--exclude-label=…
Exclude strings with the specified labels from auto-translation. Can be specified multiple times

--source-language=…
Auto-translate from the specified source language

--ai-prompt=…
AI Prompt Identifier. Required for 'ai' method

-h, --help
Display help message and exit

Config Options

-T, --token=…
Personal access token required for authentication

--base-url=…
Base URL of Crowdin server for API requests execution

--base-path=…
Path to your project directory on a local machine

-i, --project-id=…
Numeric ID of the project

-s, --source=…
Path to the source files

-t, --translation=…
Path to the translation files

--dest=…
Specify file name in Crowdin

--preserve-hierarchy
Save the directory hierarchy in the Crowdin project

--no-preserve-hierarchy
Strip the common parent directory from the file paths in the Crowdin project

Global Options

-v, --verbose
Provide more information about the command execution

-c, --config=…
Specify a path to the configuration file

--identity=…
Specify a path to user-specific credentials

--no-colors
Disable colors and styles

--no-progress
Disable progress on executed command

-o, --output=…
Change output format (choices: "json", "toon", "plain")

Examples

crowdin auto-translate -l fr -l uk --method tm --file src/values/strings.xml
crowdin auto-translate -l fr --method mt --engine-id 5 --file src/values/strings.xml
crowdin auto-translate -l fr --method mt --engine-id 5 --branch main --file src/values/strings.xml