Repository navigation
Description
Help Mote to speak more languages! Anyone wishing to volunteer, here are the steps. No programming is involved: you translate one text file and send it back.
1. Get the template
Download po/mote.pot from main: https://raw.githubusercontent.com/hyprlab/mote/main/po/mote.pot
It lists every string the app shows (about 350), each with an empty slot for the translation.
2. Make your language file
The file is named after the language code: de.po for German, es.po for Spanish, it.po for Italian. Add a region only when it matters, like pt_BR.po for Brazilian Portuguese.
Open the template in a translation editor such as Poedit (https://poedit.net, free) or Gtranslator (in GNOME Software), pick your language when asked, and save it under that name. If you prefer the command line, replace de with your code: msginit --locale=de --input=mote.pot --output=de.po.
3. Translate
- Text in curly braces, like
{name}or{n}, is filled in by the app. Keep it exactly as written, but move it anywhere the sentence needs it. - Some entries are counted things, like "1 connection" and "3 connections". Give as many forms as your language uses. Poedit shows the right number of slots once you pick the language.
- Labels for settings and buttons can be short. The longer strings are explanations under a setting.
- Protocol and product names (RDP, SSH, GNOME Remote Desktop, xrdp, KRdp) stay as they are. Key names such as Ctrl+Alt+Delete can follow what your keyboards print.
- Leave anything you are unsure about empty. An empty translation falls back to the English text, so a partial file is still useful.
4. Send it back
Either open a pull request adding po/<code>.po to main, or simply attach the file to a comment here (rename it to end in .po.txt, since GitHub only accepts certain file types). I will take it from there: add your language to the language list, credit you in the About window and the release notes, build a beta, and let you know so you can see it in the app.
5. Checking your work (optional)
Poedit's "Validate" checks the file. From a source checkout, tools/build-locale.sh followed by LANG=de_DE.UTF-8 ./target/debug/mote (with your own locale in place of de_DE) runs the app in your language.
The full guide lives at https://github.com/hyprlab/mote/blob/main/po/README.md. The template is refreshed each time strings change, so a later update of your file is a quick "update from template" in Poedit rather than starting over.
Activity