Skip to content

VC365/volume-pulse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

68 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 | gtk2
  • libfm-gtk2 (for lxde)

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):

Usage: volume-pulse [-h --help] [-m] [-i] [-d] [-l] [-v]
    -m, --mute                       Toggle mute
    -i, --increase                   Increase volume
    -d, --decrease                   Decrease volume
    -l, --level                      Show volume level
    -v, --version                    Version
    -h, --help                       Show help message
		 config path: ~/.config/volume-pulse/config.conf

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