~schnouki/pustule

Rule-based volume control for PulseAudio.
e3f78453 — Thomas Jost 1 year, 4 months ago
Make Lua 5.3 a hard dependency
c18aac2a — Thomas Jost 4 years ago
Improved code layout
cd1a3cac — Thomas Jost 4 years ago
Add a man page formatted using scdoc

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~schnouki/pustule
read/write
git@git.sr.ht:~schnouki/pustule

You can also use your local clone with git send-email.

#pustule

pustule is a rule-based volume control for PulseAudio.

By writing some simple rules in Lua, it is possible to easily control the volume of all the applications that use PulseAudio to play sound on a computer.

The default configuration file, provided with pustule, shows some of these possibilities:

  • music players have their volume set to 50%
  • video players and web browsers have their volume set to 80%
  • other sounds are played at 60%

#Version

0.1

#Tech

pustule is written in C. It's very lightweight and has few dependencies:

  • PulseAudio (specifically libpulse), as it acts as a PulseAudio client
  • Lua, a lightweight, extensible programming language
  • scdoc, a simple man page generator (to generate the documentation).

#Installation

git clone https://git.sr.ht/~schnouki/pustule
cd pustule
git submodule update --init
make

The default configuration file is pustule.lua. It's actually not a simple configuration file, but a Lua script, as documented below.

./pustule --config pustule.lua

If you don't add the --config option, pustule will try to load ~/.config/pustule.lua.

#Configuration

TODO.

#License

GPLv3+