How to: Translations

Adding new language

1. Copy and rename English localization file english.xaml from Localization folder

2. Edit new file and change following strings:

   • LocalizationLanguage - should be the same as name of new file without extension
   • LocalizationString - display string of new language (will be visible in settings window when changing language)

3. Translate all strings in new file

   • Keep formating of strings marked with xml:space="preserve", especially new lines and white spaces. Otherwise text may not display properly in application.

4. Start Playnite and test that new localization file works properly

5. Submit pull request with new localization file

   • Alternatively open new issue and attach new localization file there, if you don't have working Git setup

Updating existing language

To update localization file with new strings (after new Playnite update adds new strings into english.xaml), do following:

1. Download UpdateLocFiles.ps1 script

2. If this is first you are running PowerShell script, start PowerShell as administrator and type following: Set-ExecutionPolicy Unrestricted

3. Execute script with following parameters:

   • SourceDictionary - full path to english.xaml file
   • TargetDictionary - full path to localization file that should be updated with new strings

Example:

.\UpdateLocFiles.ps1 -SourceDictionary "c:\Playnite\Localization\english.xaml" -TargetDictionary "c:\Playnite\Localization\czech.xaml"

4. Localization file should be now updated with all missing strings from original English version