https://codeberg.org/dnkl/fnott

Keyboard driven and lightweight Wayland notification daemon for wlroots-based compositors.
https://codeberg.org/dnkl/fnott

notifications wayland wlroots

Last synced: 6 days ago
JSON representation

Keyboard driven and lightweight Wayland notification daemon for wlroots-based compositors.

• Host: codeberg.org
• URL: https://codeberg.org/dnkl/fnott
• Owner: dnkl
• Created: 2019-11-18T21:10:37.000Z (almost 5 years ago)
• Default Branch: master
• Last Synced: 2023-08-08T22:40:02.185Z (over 1 year ago)
• Topics: notifications, wayland, wlroots
• Language:
• Homepage:
• Size: 1.56 MB
• Stars: 55
• Forks: 12
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hyprland - fnott

README

        
[![CI status](https://ci.codeberg.org/api/badges/dnkl/fnott/status.svg)](https://ci.codeberg.org/dnkl/fnott)

# Fnott

Fnott is a keyboard driven and lightweight notification daemon for

wlroots-based Wayland compositors.

It implements (parts of) the [Desktop Notifications Specification](https://specifications.freedesktop.org/notification-spec/latest/).

[![Packaging status](https://repology.org/badge/vertical-allrepos/fnott.svg?columns=4)](https://repology.org/project/fnott/versions)

Supports styling and progress hints:

![screenshot](screenshot.png "Hello World screenshot")

Notifications are automatically sized (with the possibility of

limiting their max width and height):

![screenshot-2](screenshot-2.png

"Screenshot of multiple notifications")

## Supported features

* Summary

* Body

* Actions (requires a dmenu-like utility to display and let user select action)

* Urgency

* Icons

  - PNGs (using libpng)

  - SVGs (using bundled [nanosvg](https://github.com/memononen/nanosvg))

* Markup

* Timeout

More documentation is available in the installed man pages:

 * [man fnott](./doc/fnott.1.scd) documents the server

 * [man fnottctl](./doc/fnottctl.1.scd) documents the client

 * [man fnott.ini](./doc/fnott.ini.5.scd) documents the configuration

## Requirements

### Running

* fontconfig

* freetype

* pixman

* libpng

* wayland (_client_ and _cursor_ libraries)

* wlroots\*

* dbus

* [fcft](https://codeberg.org/dnkl/fcft), _unless_ built as a subproject

\* Fnott must be run in a Wayland compositor that implements the

wlroots protocols.

### Building

In addition to the dev variant of the packages above, you need:

* meson

* ninja

* scdoc

* wayland-protocols

* [tllist](https://codeberg.org/dnkl/tllist), _unless_ built as a subproject

## Usage

Copy the example `fnott.ini` to `${HOME}/.config/fnott/fnott.ini` and

edit to your liking.

Start the daemon by running `fnott`. Keep in mind that your environment

should start it automatically when a notification is emitted.

if your environment doesn't do it automatically,

you need to start a `dbus` session yourself:

```sh

dbus-daemon --session --address=unix:path=$XDG_RUNTIME_DIR/bus

```

Test it with e.g. `notify-send "this is the summary" "this is the body"`.

Use `fnottctl dismiss` to dismiss the highest priority notification

(usually the oldest), `fnottctl dismiss all` to dismiss **all**

notifications, or `fnottctl dismiss ` to dismiss a specific

notification (use `fnottctl list` to list currently active

notifications).

Use `fnottctl pause` to disable notifications. `fnottctl unpause` will

re-enable notifications.

Additionally if you compositor implements either the KDE idle

protocol, or the newer idle-notify protocol, fnott will not dismiss

any notification if you are idle by the amount of time configured in

`fnott.ini`

You can also click on a notification to dismiss it.

Note: you probably want to bind at least `fnottctl dismiss` to a

keyboard shortcut in your Wayland compositor configuration.

## Installation

To build, first, create a build directory, and switch to it:

```sh

mkdir -p bld/release && cd bld/release

```

Second, configure the build (if you intend to install it globally, you

might also want `--prefix=/usr`):

```sh

meson --buildtype=release ../..

```

Three, build it:

```sh

ninja

```

You can now run it directly from the build directory:

```sh

./fnott

```

Test that it works:

```sh

notify-send -a "MyApplicationName" "This Is The Summary" "hello world"

```

Optionally, install it:

```sh

ninja install

```

## License

Fnott is released under the [MIT license](LICENSE).

Fnott uses nanosvg, released under the [Zlib

license](3rd-party/nanosvg/LICENSE.txt).