Skip to content

Lightweight volume notification for Linux

License

Notifications You must be signed in to change notification settings

eterniter06/volnoti

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Volnoti

Volnoti is a lightweight volume notification daemon for GNU/Linux and other POSIX operating systems. It is based on GTK+ and D-Bus and should work with any sensible window manager. The original aim was to create a volume notification daemon for lightweight window managers like LXDE or XMonad. It is known to work with a wide range of WMs, including GNOME, KDE, Xfce, LXDE, XMonad, i3 and many others. The source code is heavily based on the GNOME notification-daemon.

Why another fork?

The original repo https://github.com/davidbrazdil/volnoti has had no signs of activity since the last decade. This fork incorporates some of the pull requests from the original repo that seemed to be useful:

along with some other feature(s) that I wanted:

Other changes to the project include help message changes, change in an error message, a changed brightness icon and an updated PKGBUILD file for arch linux (not in AUR).

Distribution packages

  • Arch Linux

Dependencies

You need the following libraries to compile Volnoti yourself. Please install them through the package manager of your distribution, or follow installation instructions on the projects' websites.

You can compile it with standard GCC, with make and pkg-config installed, and you will need autoconf and automake if you choose to compile the Git version.

Compilation from Git

Start by downloading the source code from GitHub:

$ git clone git://github.com/davidbrazdil/volnoti.git
$ cd volnoti

Let Autotools create the configuration scripts:

$ ./prepare.sh

Then just follow the basic GNU routine:

$ ./configure --prefix=/usr
$ make
$ sudo make install

You can have the .tar.gz source archive prepared simply by calling a provided script:

$ ./package.sh

Compilation from source archive

Download the .tar.gz source archive from the GitHub page, and then extract its contents by calling:

$ tar xvzf volnoti-*.tar.gz

Then just follow the basic GNU routine:

$ ./configure --prefix=/usr
$ make
$ sudo make install

Running the application

Firstly, you need to running the daemon (add it to your startup applications):

$ volnoti

Consult the output of volnoti --help if you want to see debug output ot don't want the application to run as a daemon. You can also change some parameters of the notifications (like their duration time) through the parameters of the daemon.

Once the daemon is running, you can run for example:

$ volnoti-show 25

to show a notification for volume level 25%. To show a notification for muted sound, call:

$ volnoti-show -m

To show a notification for muted microphone, run:

$ volnoti-show -c

To show a notification for un-muted microphone, run:

$ volnoti-show -u

To show a notification for brightness level 50%, run:

$ volnoti-show -b 50

Custom activity icons at runtime

To show a notification for a custom activity, you can pass the absolute path to the icon with:

$ volnoti-show -p /home/chad/svgs/gaming.svg

This option can also take an integer for the progressbar value. (Default value for the progressbar is 0):

$ volnoti-show -p /home/chad/svgs/play.svg 73

No Progressbar

For icons that do not need a progressbar, simply pass 101 as the progressbar value:

$ volnoti-show -p /home/chad/svgs/previous.svg 101

The best way to use volnoti is to create a simple script and attach it to the hot-keys on your keyboard. But this depends on your window manager and system configuration.

Theming

Some parameters of the notifications can be changed through the parameters of the daemon. To learn more, run:

$ volnoti --help

All the images are stored in /usr/share/pixmaps/volnoti (depending on the chosen prefix during configuration phase) and it should be easy to replace them with your favourite icons.

Credits

About

Lightweight volume notification for Linux

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 93.9%
  • Makefile 2.5%
  • Shell 2.2%
  • M4 1.4%