Skip to content
This repository has been archived by the owner on Jan 23, 2023. It is now read-only.
/ zvuchno Public archive

i3wm-compatible PulseAudio volume notification service. Actually could be used with any WM. TWIMC: This REPO IS MIRROR of my self-hosted git.

License

Notifications You must be signed in to change notification settings

thekondor/zvuchno

Repository files navigation

🎵 Zvuchno

Yet another simple PulseAudio volume notification service over libnotify. The service provides notification for:

  • Volume up/down
  • Volume mute/unmute

In action

Change of volume's level is visualized using a textual progress bar. No graphics, no other extra complex use-cases is an intention. The text is customizable: ASCII and Emojis.

The app was written as tiny entertainment to close a gap in my existing i3wm setup. My alternative to volnoti daemon.

Build & Configuration

Build:

  • $ git clone https://git.thekondor.net/zvuchno.git or ($ git clone https://github.com/thekondor/zvuchno)
  • $ cd zvuchno && go build

Run w/o any configuration file to use default settings. Or use config.sample.yml as a foundation for personal one. The configuration file could be stored either as $HOME/.zvuchno.yml or $XDG_CONFIG_HOME/zvuchno.yml.

The application heavily relies on running PulseAudio daemon as well as available DBus session.

Format

The final volume's level representation is defined via appearance.format.full key. The value's format is simply a Go's template. {{ .Percent }} is expanded to current volume's level in percent. {{ .Bar}} is expanded to a textual representation of current volume's level.

Bar's representation is defined via appearance.format.bar key. The value is 5-character string. Example: [=>-], where

  1. [ is a left border of the bar.
  2. = is a floating part of the bar.
  3. > is a pointer of the floating part showing current volume's level.
  4. - is a remaining space for the bar to float to.
  5. ] is a right border of the bar.

Any character here could be a regular ASCII one as well as a fancy Emoji (should be supported by active font)

Usage

As simple as:

$ zvuchno

or to be added to ~/.xinitrc (or i3wm/config... whatever!) for a launch on WM startup:

# Mind '&' at the end!
/path/to/zvuchno &

About

i3wm-compatible PulseAudio volume notification service. Actually could be used with any WM. TWIMC: This REPO IS MIRROR of my self-hosted git.

Topics

Resources

License

Stars

Watchers

Forks