1.11.1 Macros

Macro: declaration-prop-props x ¶

Undocumented macro.

Macro: declaration-property x ¶

Undocumented macro.

Macro: declaration-value x ¶

Undocumented macro.

Macro: declaration? x ¶

Undocumented macro.

Macro: make-declaration x ¶

Undocumented macro.

Macro: make-declaration-prop x ¶

Undocumented macro.

Macro: make-rule x ¶

Undocumented macro.

Macro: rule-declarations x ¶

Undocumented macro.

Macro: rule-selector x ¶

Undocumented macro.

Macro: rule? x ¶

Undocumented macro.

Macro: set-rule-selector! x ¶

Undocumented macro.

1.11.2 Parameters

Parameter: niri-caps-to-ctrl? ¶

Default value:

#t

Parameter: niri-config-dir ¶

Default value:

"/root/.config/niri"

Parameter: niri-config-filename ¶

Default value:

"config.kdl"

Parameter: niri-extra-startups ¶

Default value:

()

Parameter: niri-keyboard-layout ¶

Default value:

"us"

Parameter: niri-mono-font ¶

Default value:

"Intel One Mono"

Parameter: niri-natural-scroll? ¶

Default value:

#f

Parameter: niri-palette ¶

Default value:

modus-vivendi-tinted

Parameter: niri-sans-font ¶

Default value:

"Lucida Sans"

1.11.3 Procedures

Procedure: dec property value ¶

Construct a KDL declaration node from a property and its value.

The property is usually a symbol such as layout or theme; the value is whatever that property expects, a string being rendered as a quoted KDL value. Declarations are grouped into rules by rul and written out by serialize-declaration.

Procedure: install-niri-config ¶

Generate and serialize the target Heks Linux system active attributes pipeline configuration directly to disk space.

Procedure: niri-config KEY: #:palette #:sans-font #:mono-font #:keyboard-layout #:caps-to-ctrl? #:extra-startups ¶

Assemble the master schema manifest containing layout properties, hooks, bindings, animations and rules ready for serialization.

Procedure: niri-spring KEY: #:stiffness ¶

Build a spring animation declaration for the niri animations block: critically damped, quick and soft.

Procedure: prop props ¶

Construct a KDL declaration-prop node from a list of properties.

Unlike dec, which carries a single property and its value, this wraps a whole group. That is how Niri rules express nested tables, such as a window rule’s property list.

Procedure: rul selector . args ¶

Construct a KDL rule node with a given selector symbol and nested arguments.

(rul 'cursor (dec 'size 24))

Procedure: serialize-bindings xs ¶

Format an association list array of keybinding declarations xs into valid KDL key binding rulesets with inline hotkey overlay titles.

Procedure: serialize-declaration xs ¶

Convert individual property-value configurations into structurally typed KDL declaration syntax values.

Procedure: serialize-kdl xs KEY: #:indent ¶

Recursively transform record definitions and vectors xs into string blocks validating KDL configuration semantics.

1.11.4 Record Types

Record type: declaration ¶

This record type has the following fields:

• property
• value

Record type: declaration-prop ¶

This record type has the following fields:

• props

Record type: rule ¶

This record type has the following fields:

• selector
• declarations