Rust Pulse Audio Mixer

This started a project to test my Rust chops after going through the rust book. It uses libpulse-binding to drive the interadtion with the Pulse server. It currently offers enough features to bind to keypresses for increasing, decreasing, and muting the default sink (speakers).

Install

Use Cargo

cargo install rupamix --profile optimized

Manual

git clone git@github.com:fitpaulo/rupamix.git \
&& cd rupamix \
&& cargo build --profile optimized

Make it visible to your WM/Desktop

To use it with your window manger, i.e. bind it to a keyboard press, your window manager needs to see the binary. The easiest way is to copy the execsuteale into /usr/bin (this assumes you installed with cargo)

sudo cp $HOME/.cargo/bin/rupamix /usr/bin/.

Or you can link it:

sudo ln -sf $HOME/.cargo/bin/rupamix /usr/bin/.

Usage examples

To increase the audio by the defualt 5:

rupamix volume --increase

To increase the audio by N:

rupamix volume --increase <N>

To decrease the audio by the defualt 5:

rupamix volume --decrease

To decrease the audio by N:

rupamix volume --decrease <N>

To set the volume directly

rupamix volume set 120 --boost 

To mute/unmute

rupamix volume --toggle-mute

You can specify the sink as well

To get the list of sink indexes and names:

rupamix print --volume

        Index -- Name                                             
--------------------------------------------------------------------
          146 -- alsa_output.pci-0000_0b_00.4.iec958-stereo       
(default) 150 -- alsa_output.usb-Audient_iD4-00.HiFi__hw_iD4__sink
          315 -- alsa_output.pci-0000_09_00.1.hdmi-stereo-extra2  

Then update a sink like the following:

rupamix --index 146 volume --increase 10

OR

rupamix --name alsa_output.pci-0000_0b_00.4.iec958-stereo volume --increase 10