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 8.0: To install and use Overcrowdin, you need .NET 8.0, 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 8.0
- Visual Studio Community Edition 2022 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