Skip to content

Localization

Option Type Default Description
marchyo.timezone string "Europe/Zurich" System timezone
marchyo.defaultLocale string "en_US.UTF-8" System default locale
marchyo.language enum derived from marchyo.defaultLocale Display language of the Marchyo shell and CLI strings
marchyo.autoTimezone.enable bool false Update the timezone automatically from your location
{
marchyo.timezone = "America/New_York";
marchyo.defaultLocale = "de_DE.UTF-8";
}

marchyo.language sets the language of Marchyo’s own UI: the shell panels and the marchyo CLI messages. Only English ("en") ships today, so it is the only accepted value and the default; the option and the shell/i18n catalog layer stay in place so translations can be added later. Once more catalogs exist, the default follows marchyo.defaultLocale (an exact locale match first, then the bare language) and falls back to "en"; strings without a translation show in English.

{
marchyo.defaultLocale = "fi_FI.UTF-8"; # system LANG; the Marchyo UI stays English
marchyo.language = "en"; # optional, the only shipped language
}

The system LANG changes only when you rebuild. marchyo language changes the Marchyo UI live, without a rebuild:

Terminal window
marchyo language # show the current language
marchyo language list # list the supported codes
marchyo language en # switch the shell and CLI to a listed language
marchyo language --revert # back to marchyo.language

The command stores a runtime override that survives rebuilds and marchyo runtime restore; --revert drops it. Other programs keep following LANG.

marchyo.autoTimezone.enable is opt-in and off by default. When enabled, it turns on services.automatic-timezoned (a geoclue2-based daemon) to keep the system timezone current based on your location:

{
marchyo.autoTimezone.enable = true;
}
Timezone Region
"Europe/Zurich" Central Europe (default)
"Europe/London" United Kingdom
"Europe/Helsinki" Finland
"America/New_York" US Eastern
"America/Los_Angeles" US Pacific
"Asia/Tokyo" Japan
"Asia/Shanghai" China