#desktop-environment #notifications #quality-of-life

app qssnotify

An utility that allows to regularly display notifications in the Desktop environment. Useful to help you remember that you should take care of yourself and cuddle your cat (among other things)

1 stable release

1.0.0 Jul 5, 2023

#23 in #desktop-environment

Custom license

37KB
822 lines

QSSNotify

What is it ?

A small CLI project written in Rust that allows to display on your Linux desktop environment using the native notification system. It is not suited for regular timed reminders like you'd expect from an agenda or a To-do list, but more thought to display regular messages (Soothing stuff, reminders to take breaks or take care of yourself).

Which OSes and desktop environments are supported ?

It has been tested only on GNOME. It should probably work in a lot of desktop environments since QSSNotify depends on a crate to handle this part. It may also work on Windows...

How do you build it ?

Just go into the root of the project and call cargo run --release. The binary will be at ${PWD}/target/release/qssnotify You need cargo (part of the Rust toolchain) to build it.

How do you use it ?

qssnotify --help should give you a lot of information about the interface the CLI provides. By default, QSSNotify uses nvim as its text editor, but you can change it by editing the configuration file located in ~/.qssnotify/config, You can also change the delay between each notifications in this file.

You must add qssnotify --daemon to the list of the programs that are launched automatically when your desktop environment is launched, then QSSNotify will regularly display a notification with one of the sentences you've registered, chosen at random.

  • qssnotify --add : Opens a text editor so that you can write the sentence you want to be registered. When leaving the editor, the written sentence will be saved internally.
  • qssnotify --list : Lists all registered sentences with their associated hash.
  • qssnotify --edit <HASH> : Edits the sentence whose hash is given in parameter in a text editor.
  • qssnotify --delete <HASH> : Deletes the sentence whose hash is given in parameter

Dependencies

~10–40MB
~630K SLoC