Crowdin is an amazing, popular, cloud-based localization management system. It provides a CLI in Java, but that adds dependencies that many projects do not want. This project provides an alternative in the form of a .NET Core Global Tool.
Overcrowdin is a dotnet CLI built on top of the Crowdin project crowdin-dotnet-client, which provides a .NET Api over the Crowdin REST API.
This project is not yet feature complete with the Crowdin client. It was built to meet some immediate project needs and could be enhanced.
- .NET Core 2.1 : To install and use Overcrowdin, you need .NET Core 2.1, which can be downloaded from Microsoft's website.
Overcrowdin can be installed using the following command:
dotnet tool install -g overcrowdin
After installation, overcrowdin
will be available from the command prompt.
Overcrowdin uses a configuration file named crowdin.json
in the working directory. This file follows the structure of Crowdin's YAML configuration file.
To see the program help, run overcrowdin
with no options.
Q: Why don't you save the API Key in the configuration file?
A: I don't want to make it easy to commit secrets into a github repository so I encourage the environment variable option that Crowdin supports in their CLI.
- .NET Core 2.1
- Visual Studio Community Edition 2017 or later
git clone https://github.com/sillsdev/overcrowdin
Then you should be able to build the solution and run the unit tests
dotnet build
cd OvercrowdinTests
dotnet test