PulseAudio Sink Cycle

Pats is a command-line tool for managing PulseAudio audio sinks that allows you to list available audio outputs and cycles between them seamlessly.

Features

How to use

[!IMPORTANT] Make sure you have the required dependencies installed before building the project.

First, ensure you have the necessary development libraries installed:

# On Void Linux
sudo xbps-install -S pulseaudio-devel

# On Debian/Ubuntu
sudo apt-get install libpulse-dev

# On Fedora/RHEL
sudo dnf install pulseaudio-libs-devel

# On Arch Linux
sudo pacman -S pulseaudio

Build the project:

make
sudo make install

Command line options

The tool supports several command line options:

pats [OPTIONS]

Options:
  -l, --list     List all available audio sinks
  -t, --toggle   Toggle between available audio sinks
  -h, --help     Show this help message

Examples

List all available audio sinks:

pats --list

Toggle to the next available audio sink:

pats --toggle

Short option syntax:

pats -l    # List sinks
pats -t    # Toggle sinks

Building from source

The project uses a simple Makefile for building. Available targets:

make                  # Build the executable (default)
make clean            # Remove build artifacts
sudo make install     # Install to /usr/local/bin/
sudo make uninstall   # Remove from /usr/local/bin/

Debugging

Enable verbose output by modifying the source code or using debugging tools like gdb:

gdb ./pats

License

pats was written by Mitja Felicijan and is released under the BSD two-clause license, see the LICENSE file for more information.