volume-pulse v0.2.6

a lightweight volume control applet for Linux.

Volume Pulse

Volume Pulse is a lightweight volume control utility for Linux systems. It runs in the system tray and allows you to control your audio output using mouse scroll, tray icon clicks, or your system’s volume keys. Volume Pulse is written in (C & Crystal) and uses the GTK2 toolkit for its graphical interface.

Features

  • Tray icon with real-time volume status
  • Mouse scroll support to increase/decrease volume
  • Left click to toggle mute
  • Middle click can be set to open a mixer or mute
  • Optional notification popups
  • Volume shortcuts support (XF86 keys)
  • Simple config file for customization

Installation

Requirements

  • pulseaudio
  • pavucontrol (for mixer)
  • libnotify
  • libgtk-2-dev

Using AUR

paru -S volume-pulse
# or
yay -S volume-pulse

Manual Installation

git clone https://aur.archlinux.org/volume-pulse.git
cd volume-pulse
makepkg -si

Using the installer script

chmod a+x install.sh
./installer.sh install crystal
# OR
./installer.sh install c 

To uninstall:

./installer.sh uninstall

Usage

volume-pulse &

Configuration

Edit ~/.config/volume-pulse/config.conf to customize behavior.

Example config:

volume_increase = 5
max_volume = 200%

# "false", "mixer", "mute"
middle_click_action = mixer

mixer = pavucontrol

use_notifications = false

# Enable keyboard shortcuts (X11 only)
use_shortcuts = true

use_arguments = true

CLI Options

You can also control the volume from the terminal (best option for custom shortcuts):

volume-pulse -u   # Volume up
volume-pulse -d   # Volume down
volume-pulse -m   # Toggle mute
volume-pulse -s   # Show volume level
volume-pulse -v   # Version info

Contributing

  1. Fork it (https://github.com/VC365/volume-pulse/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

  • VC365 - creator and maintainer
Repository

volume-pulse

Owner
Statistic
  • 1
  • 0
  • 0
  • 0
  • 0
  • 12 days ago
  • June 27, 2025
License

GNU General Public License v3.0

Links
Synced at

Wed, 22 Oct 2025 00:54:20 GMT

Languages