Mixxc
Mixxc is a minimalistic and customizable volume mixer, created to seamlessly complement desktop widgets. Currently, it supports only pulseaudio
and pipewire
(through the pulseaudio interface) by utilizing libpulseaudio
to receive audio events.
Usage
Usage: mixxc [-w <width>] [-h <height>] [-s <spacing>] [-a <anchor...>] [-m <margin...>] [-u <userstyle>] [-v]
Minimalistic volume mixer.
Options:
-w, --width window height
-h, --height window width
-s, --spacing spacing between clients
-a, --anchor screen anchor point: (t)op, (b)ottom, (l)eft, (r)ight
-m, --margin margin distance for each anchor point
-u, --userstyle path to the userstyle
-v, --version print version
--help display usage information
Anchoring
It is often desirable to be able to position widgets relatively to a screen side.
Two flags will help with this: -a --anchor
and -m --margin
.
Each margin value provided will match every anchor point respectively.
mixxc --anchor left --anchor bottom --margin 20 --margin 30
Customization
Mixxc is built with GTK4 and uses CSS to define its appearance.
You will find the style sheet in your config directory after the first launch.
${XDG_CONFIG_HOME:-$HOME/.config}/mixxc/style.css
If you have enabled the Sass feature, it will also look for *.scss and *.sass files.
${XDG_CONFIG_HOME:-$HOME/.config}/mixxc/style.sass
${XDG_CONFIG_HOME:-$HOME/.config}/mixxc/style.scss
Environment
Mixxc is developed and tested with:
- Wayland
- Hyprland
- PipeWire
If your setup is different and you experience issues, feel free to file a bug report.
Startup Time
If startup seems a bit slow, try this:
GSK_RENDERER=cairo GTK_USE_PORTAL=0 mixxc
Dependencies
- GTK4
- gtk4-layer-shell (Feature: Wayland)
- libpulseaudio (Feature: PulseAudio)
- libxcb (Feature: X11)
Features
Some features can be enabled at compile time.
- Sass - Allows you to use SCSS instead of CSS.
- Wayland - Uses wlr-layer-shell to imitate window positioning.
- X11 - Sets WM hints and properties, and repositions the window.
Installation
Can be installed from crates.io with cargo
:
cargo install mixxc --locked --features Sass,Wayland...
Building
To build this little thing, you'll need some Rust.
git clone --depth 1 https://github.com/Elvyria/mixxc
cd mixxc
cargo build --locked --release --features Sass,Wayland...