fnott(5) | File Formats Manual | fnott(5) |
fnott - configuration file
fnott uses the standard unix configuration format, with section based key/value pairs. The default (global) section is unnamed (i.e. not prefixed with a [section]). However it can also be explicitly named [main], say if it needs to be reopened after any of the other sections.
fnott will search for a configuration file in the following locations, in this order:
output
Note that if you do not specify an output, and the output chosen by the compositor is scaled, then each new notification will flash a low-res frame before re-rendering with the correct scale factor. This is because fnott has no way of knowing what the scale factor is until after the notification has been mapped (i.e. shown).
Default: unspecified.
In Sway, you can use swaymsg -t get_outputs to get a list of available outputs.
min-width
max-width
max-height
icon-theme
max-icon-size
stacking-order
Thus, if the notifications are anchored at the top, bottom-up will have the most recent notification in the upper corner, while the oldest notification is in the bottom of the stack.
Default: bottom-up.
anchor
edge-margin-vertical
edge-margin-horizontal
notification-margin
selection-helper
The utility should accept (action) entries to display on stdin (newline separated), and write the selected entry on stdout.
It is strongly recommended that you enable selection-helper-uses-null-separator (see below), if your helper of choice supports it.
Default: dmenu.
selection-helper-uses-null-separator
Note that you may also have to adjust selection-helper, to ensure the selection helper parses the action strings correctly. For example, instead of fuzzel --dmenu, you would have to use fuzzel --dmenu0.
Default: no.
play-sound
scaling-filter
Possible values are:
none is the fastest, but also looks the worst. lanczos3 produces the best result, but is also, by far, the slowest option.
Default: lanczos3
These options can also be specified in an urgency section, in which case they override the values specified in the default section.
layer
background
border-color
border-radius
border-size
padding-vertical
padding-horizontal
dpi-aware
When set to yes, fonts are sized using the monitor's DPI, making a font of a given size have the same physical size, regardless of monitor.
In this mode, the monitor's scaling factor is ignored; doubling the scaling factor will not double the font size.
When set to no, the monitor's DPI is ignored. The font is instead sized using the monitor's scaling factor; doubling the scaling factor does double the font size.
Note that this option typically does not work with bitmap fonts, which only contains a pre-defined set of sizes, and cannot be dynamically scaled. Whichever size (of the available ones) that best matches the DPI or scaling factor, will be used.
Also note that if the font size has been specified in pixels (:pixelsize=N, instead of :size=N), DPI scaling (dpi-aware=yes) will have no effect (the specified pixel size will be used as is). But, if the monitor's scaling factor is used to size the font (dpi-aware=no), the font's pixel size will be multiplied with the scaling factor.
Default: no
title-font
title-color
title-format
summary-font
summary-color
summary-format
body-font
body-color
body-format
progress-bar-height
progress-bar-color
max-timeout
default-timeout
idle-timeout
sound-file
icon
In the latter case, it will be searched for in the selected icon theme, using the fallback rules defined by the XDG icon theme specification.
Default: unset.
This section allows you to override the options listed under per-urgency default options for low priority notifications.
By default, the following options are already overridden:
This section allows you to override the options listed under per-urgency default options for normal priority notifications.
By default, the following options are already overridden: none.
This section allows you to override the options listed under per-urgency default options for critical priority notifications.
By default, the following options are already overridden:
The font is specified in FontConfig syntax. That is, a colon-separated list of font name and font options.
Examples:
The title-format, summary-format and body-format options allow you to configure what to display for the corresponding portion of the notification.
They are strings with placeholders that are expanded with attributes from the notification:
Also supported are the following markup tags:
fnott(1)
2025-01-08 |