NAME

SYNOPSIS

Configuration for the nd plugin.

DESCRIPTION

The nd plugins provides on-screen notifications (aka “bubbles”). It depends on backends to display them.

GLOBAL SECTIONS

Section [NotificationXcb]

The XCB backend configuration

Outputs=

A list of output names

The backend will try to find the first available output in the list. If none is found, it will fallback to the primary output, then to use the full screen.

Anchor= (defaults to top-right)

An enumeration: top left, top, top right, bottom left, bottom, bottom right

The screen place in which the bubble will be anchored.

OldestFirst= (defaults to false)

A boolean

If true, the first bubble is the oldest, new bubbles will be pushed at the end of the queue.

Margin= (defaults to 13)

An integer

Margin between bubble and screen's edge.

Spacing= (defaults to 13)

An integer

Spacing between each bubble.

ACTION SECTIONS

Section [Notification]

Disable=

A boolean

If true, the event will not have its bubble.

Other settings are inherited from the global configuration. You may override them on an action basis.

SHARED SECTIONS

These sections are valid in both global and action configurations.

Section [Notification]

This section can accept other keys

Contents keys

Title= (defaults to "${title}")

A localised format string

The notification's title. It will be highlighted compared to the message.

Message= (defaults to "${message}")

A localised format string

The notification's message.

Image= (defaults to "image")

A file URI

The notification's image. Generally event-specific.

Icon= (defaults to "icon")

A file URI

The notification's icon. Generally application-specific or category-specific.

Style keys

Following keys define the style of the bubble's contents.

Section [NotificationBubble]

Timeout= (defaults to 3000)

A time in milliseconds

Time for which the bubble will appear on screen.

MinWidth= (defaults to 200), MaxWidth= (defaults to -1, unlimited)

Two integers, -1 is unlimited

These two keys control the bubble width.

The maximum width overrides the minimum.

Padding= (defaults to 10)

An integer

Padding between bubble's contents and border.

Radius= (defaults to 10)

An integer

Radius of bubble's corners.

Colour= (defaults to "#262626")

A colour string

Colour of bubble's background.

Section [NotificationTitle]

Font= (defaults to "Linux Libertine O Bold 9")

A Pango font description string

Fonts for the bubble's title.

Alignment= (defaults to Left)

An enumeration: Left, Right, Center

Title text horizontal aligment.

Colour= (defaults to "#262626")

A colour string

Colour of bubble's title.

Section [NotificationMessage]

Spacing= (defaults to 5)

An integer

Spacing between bubble's title and message.

MaxLines= (defaults to 10)

An integer

Maximum lines of bubble's message to print.

Font= (defaults to "Linux Libertine O 9")

A Pango font description string

Fonts for the bubble's message.

Alignment= (defaults to Left)

An enumeration: Left, Right, Center

Message text horizontal aligment.

Colour= (defaults to "#262626")

A colour string

Colour of bubble's message.

Section [NotificationImage]

MaxWidth= (defaults to 50), MaxHeight= (defaults to 50)

Two integers, -1 is unlimited

These two keys control the image size.

Margin= (defaults to 10)

An integer

Margin between bubble's image and text.

Section [NotificationIcon]

Placement= (defaults to Background)

An enumeration: Background, Overlay, Foreground

Bubble's icon can be placed at several places.

Background

The icon is placed in the bubble's background

Margin between bubble's icon and text if placement is Foreground.

Anchor= (defaults to Center)

An enumeration: Top, Bottom, Center

Vertical icon's aligment.

Used only if placement is Background or Foreground.

MaxWidth= (defaults to 50), MaxHeight= (defaults to 50)

Two integers, -1 is unlimited

These two keys control the icon size.

Margin= (defaults to 10)

An integer

Margin between bubble's icon and text.

Used only if placement is Foreground.

FadeWidth= (defaults to 75)

A percentage as an integer

Determines the fading width when the icon is placed in background.

Used only if placement is Background.

SEE ALSO

eventd core man pages

eventd(1)

eventd daemon command-line options

eventdctl(1)

eventdctl (control tool) command-line options

eventd.conf(5)

eventd configuration

Contains information about all the event configuration

Plugins installed with eventd will use the same scheme: eventd-plugin-name for their additional eventd command-line options, eventdctl-plugin-name for their additional eventdctl command-line options, eventd-plugin-name.conf for their configuration,

Plugins man pages

• exec plugin: eventd-exec.conf(5)

• file plugin: eventd-file.conf(5)

• nd plugin: eventdctl-nd(1) eventd-nd.conf(5)

• notify plugin: eventd-notify.conf(5)

AUTHOR

Quentin Glidic <sardemff7@eventd.org>

Developer

Index

NAME

SYNOPSIS

DESCRIPTION

GLOBAL SECTIONS

Section [NotificationXcb]

ACTION SECTIONS

Section [Notification]

SHARED SECTIONS

Section [Notification]

Style keys

SEE ALSO

AUTHOR