# Internationalization (i18n)

EagleCast comes available in multiple languages thanks to language packs contributed by volunteers. A language pack is a JSON file with a map of keys and corresponding translations. The bundled languages can be [viewed here](https://source.offmarket.win/aleagle/EagleCast/src/branch/master/i18n).

## Customizing languages

To customize an existing language or to load a new language, put one or more `.json` language files in a directory, and pass the directory path to EagleCast with the<br />`--i18n-dir=/path/to/dir` flag.


## Contributing a new language


- Copy `i18n/en.json` to a new file named after the language code (e.g. `i18n/xx.json`).
- Translate the values in the JSON file.
- Send a pull request to add the file to the [i18n directory on the GitHub repo](https://source.offmarket.win/aleagle/EagleCast/src/branch/master/i18n).
