MyNixOS website logo

Configuration for twmnd in INI format. See https://github.com/sboli/twmn/blob/master/README.md for available settings. Generated files include main.port = 9797 unless configured explicitly, because TWMN requires it in a managed file.

No configuration file is generated when settings are empty. Deprecated options retain the historical defaults that disable always-on-top and bouncing and set the outgoing animation curve to 38. Forcing the whole settings value suppresses these legacy GUI defaults; forcing a section does not suppress omitted defaults. Settings-only configurations use TWMN's defaults for omitted keys. Use signed strings such as "+20" for offsets, -1 for unlimited gui.max_length, and an empty string for an unset screen or icon.

The deprecated extraConfig option remains a final override, including over forced settings. Move its values into settings and resolve any duplicate definitions when migrating.

Aliases expose final settings values, not omitted native defaults. Reading legacy aliases to derive other settings can cause infinite recursion. Use shared local bindings for related values instead.

Declarations
Type
attribute set of section of an INI file (attrs of INI atom (null, bool, int, float or string))
Default
{ }
Example
{
  gui = {
    background_color = "#000000";
    font_size = 16;
    offset_x = "+20";
  };
  main = {
    duration = 5000;
  };
}