开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Crowdin CLI  

Crowdin CLI is a command line tool that allows you to manage and synchronize your localization resources with your Crowdin project. Using CLI, you can:

• automate the process of updating your source files in your Crowdin project
• download translations from Crowdin and automatically save them in the correct locations
• upload all your existing translations to Crowdin in minutes
• integrate Crowdin with GIT, SVN, Mercurial, and other software

This is a cross-platform and it runs in a terminal on Linux based and macOS operating systems or in Command Prompt on Windows.

Table of Contents

• Features
• Installation
• Running
• Configuration
• Usage
  • General Commands
  • Uploading Resources
  • Downloading Translations
  • Versions Management
  • Advanced Usage
• Seeking Assistance
• Contributing
• Contributors
• License

Features

• Interactive generation of a configuration file
• Upload source files and existing translations to a Crowdin project
• Download latest translations from Crowdin to the specified place
• Show translation and proofreading progress for a project
• Manage source strings in a Crowdin project
• Manage glossaries and translation memories
• Show a list of source files and branches in the current project
• List information about the source files or translations that match the wild-card pattern contained in the current project
• Multithreading for source and translation files upload
• Bash/Zsh command completion
• Process indicators, loading states, emojis
• HTTP Proxy support including authorization
• To explore more features, visit the Wiki, KB article and Configuration File article.

Installation

Requirements

Check if you have Java 8 or newer installed. Type java -version command in the terminal (Command Prompt on Windows) to check Java version.

For example, java version "1.8.0_212" means that you have Java 8 Update 212 installed.

brew tap crowdin/crowdin

brew install crowdin@3

wget -qO - https://artifacts.crowdin.com/repo/GPG-KEY-crowdin | sudo apt-key add -

echo "deb https://artifacts.crowdin.com/repo/deb/ /" > /etc/apt/sources.list.d/crowdin.list

sudo apt-get update && sudo apt-get install crowdin3

wget https://artifacts.crowdin.com/repo/deb/crowdin3.deb -O crowdin.deb

sudo dpkg -i crowdin.deb

rpm --import https://artifacts.crowdin.com/repo/GPG-KEY-crowdin

[crowdin]
name=Crowdin repository
baseurl=https://artifacts.crowdin.com/repo/rpm
gpgcheck=1
gpgkey=https://artifacts.crowdin.com/repo/GPG-KEY-crowdin
enabled=1

sudo yum install crowdin3

sudo dnf install crowdin3

wget https://artifacts.crowdin.com/repo/rpm/crowdin3.rpm -O crowdin.rpm

sudo rpm -U crowdin3.rpm

npm i -g @crowdin/cli

docker pull crowdin/cli

Running

Use the following method to run the app:

crowdin

Alternative method:

java -jar crowdin-cli.jar

Configuration

Crowdin CLI uses a YAML configuration file that contains a description of the resources to manage: files to be uploaded into Crowdin and the locations of the corresponding translations.

To use Crowdin CLI, you should first generate your configuration file and then run the tool. By default, Crowdin CLI looks for a configuration file named crowdin.yaml or crowdin.yml (so you don’t have to specify the file name unless it’s different from crowdin.yaml).

To create the configuration file run the following command:

crowdin init

When calling Crowdin CLI in terminal make sure you are in your project root directory. Otherwise, you need to specify a configuration file path using --config option:

crowdin upload sources --config /path/to/your/config/file

Sample configuration file:

"project_id": "12"
"api_token": "54e01--your-personal-token--2724a"
"base_path": "."
"base_url": "https://api.crowdin.com" # https://{organization-name}.crowdin.com

"preserve_hierarchy": true

"files": [
  {
    "source" : "/resources/**/*",
    "translation" : "/%two_letters_code%/%original_file_name%"
  }
]