Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

services.twmn.enable

Whether to enable twmn, a tiling window manager notification daemon.

Type: boolean

Default:

false

Example:

true

Declared by:

services.twmn.duration

The time each notification remains visible, in milliseconds.

Type: unsigned integer, meaning >=0

Default:

3000

Example:

5000

Declared by:

services.twmn.extraConfig

Extra configuration options to add to the twmnd config file. See https://github.com/sboli/twmn/blob/master/README.md for details.

Type: attribute set

Default:

{ }

Example:

{ main.activation_command = "${pkgs.hello}/bin/hello"; }

Declared by:

services.twmn.host

Host address to listen on for notifications.

Type: string

Default:

"127.0.0.1"

Example:

"laptop.lan"

Declared by:

services.twmn.icons.critical

Path to the critical notifications’ icon.

Type: null or absolute path

Default:

null

Declared by:

services.twmn.icons.info

Path to the informative notifications’ icon.

Type: null or absolute path

Default:

null

Declared by:

services.twmn.icons.warning

Path to the warning notifications’ icon.

Type: null or absolute path

Default:

null

Declared by:

services.twmn.port

UDP port to listen on for notifications.

Type: 16 bit unsigned integer; between 0 and 65535 (both inclusive)

Default:

9797

Declared by:

services.twmn.screen

Screen number to display notifications on when using a multi-head desktop.

Type: null or signed integer

Default:

null

Example:

0

Declared by:

services.twmn.soundCommand

Command to execute to play a notification’s sound.

Type: string

Default:

""

Declared by:

services.twmn.text.color

Notification’s text color. RGB hex and keywords (e.g. lightgray) are supported.

Type: string

Default:

"#999999"

Example:

"lightgray"

Declared by:

services.twmn.text.font.package

The font package to use. Package providing the font to use for the notification text. This package is only used if font.package is not null.

Type: null or package

Default:

null

Example:

pkgs.dejavu_fonts

Declared by:

services.twmn.text.font.family

Notification text’s font family.

Type: string

Default:

"Sans"

Example:

"Noto Sans"

Declared by:

services.twmn.text.font.size

Notification text’s font size.

Type: unsigned integer, meaning >=0

Default:

13

Example:

42

Declared by:

services.twmn.text.font.variant

Notification text’s font variant.

Type: one of “oblique”, “italic”, “ultra-light”, “light”, “medium”, “semi-bold”, “bold”, “ultra-bold”, “heavy”, “ultra-condensed”, “extra-condensed”, “condensed”, “semi-condensed”, “semi-expanded”, “expanded”, “extra-expanded”, “ultra-expanded”

Default:

"medium"

Example:

"heavy"

Declared by:

services.twmn.text.maxLength

Maximum length of the text before it is cut and suffixed with “…”. Never cuts if null.

Type: null or (unsigned integer, meaning >=0)

Default:

null

Example:

80

Declared by:

services.twmn.window.alwaysOnTop

Whether to enable forcing the notification window to always be on top.

Type: boolean

Default:

false

Example:

true

Declared by:

services.twmn.window.animation.bounce.enable

Whether to enable notification bounce when displaying next notification directly.

Type: boolean

Default:

false

Example:

true

Declared by:

services.twmn.window.animation.bounce.duration

The bounce animation duration in milliseconds.

Type: unsigned integer, meaning >=0

Default:

500

Example:

618

Declared by:

services.twmn.window.animation.easeIn

Options for the notification appearance’s animation.

Type: submodule

Default:

{ }

Example:

{
  curve = 19;
  duration = 618;
}

Declared by:

services.twmn.window.animation.easeIn.curve

The qt easing-curve animation to use for the animation. See QEasingCurve documentation.

Type: integer between 0 and 40 (both inclusive)

Default:

38

Example:

19

Declared by:

services.twmn.window.animation.easeIn.duration

The animation duration in milliseconds.

Type: unsigned integer, meaning >=0

Default:

1000

Example:

618

Declared by:

services.twmn.window.animation.easeOut

Options for the notification disappearance’s animation.

Type: submodule

Default:

{ }

Example:

{
  curve = 19;
  duration = 618;
}

Declared by:

services.twmn.window.animation.easeOut.curve

The qt easing-curve animation to use for the animation. See QEasingCurve documentation.

Type: integer between 0 and 40 (both inclusive)

Default:

38

Example:

19

Declared by:

services.twmn.window.animation.easeOut.duration

The animation duration in milliseconds.

Type: unsigned integer, meaning >=0

Default:

1000

Example:

618

Declared by:

services.twmn.window.color

Notification’s background color. RGB hex and keywords (e.g. lightgray) are supported.

Type: string

Default:

"#000000"

Example:

"lightgray"

Declared by:

services.twmn.window.height

Height of the slide bar. Useful to match your tiling window manager’s bar.

Type: unsigned integer, meaning >=0

Default:

18

Example:

42

Declared by:

services.twmn.window.offset.x

Offset of the notification’s slide starting point in pixels on the horizontal axis (positive is rightward).

Type: signed integer

Default:

0

Example:

50

Declared by:

services.twmn.window.offset.y

Offset of the notification’s slide starting point in pixels on the vertical axis (positive is upward).

Type: signed integer

Default:

0

Example:

-100

Declared by:

services.twmn.window.opacity

The notification window’s opacity.

Type: integer between 0 and 100 (both inclusive)

Default:

100

Example:

80

Declared by:

services.twmn.window.position

Position of the notification slide. The notification will slide in vertically from the border if placed in top_center or bottom_center, horizontally otherwise.

Type: one of “tr”, “top_right”, “tl”, “top_left”, “br”, “bottom_right”, “bl”, “bottom_left”, “tc”, “top_center”, “bc”, “bottom_center”, “c”, “center”

Default:

"top_right"

Example:

"bottom_left"

Declared by: