MIXXC(1)

NAME
mixxc - minimalistic volume mixer

DESCRIPTION
Mixxc is a volume mixer for managing application volume levels, focused on providing a high level of customization for widget users and creators.

OPTIONS

-w, --width px
    In horizontal bar orientation it affects only the base width of the window and will not change. In vertical, it's used to specify width of each audio client.

-h, --height px
    In vertical bar orientation it only affects the base height of the window and will not change. In horizontal, it will be ignored if window requires more space.

-s, --spacing px
    Space gap between audio clients in pixels.

-a, --anchor side
    Snap window to the side of the screen. Can be specified multiple times.
    •   t, top
    •   b, bottom
    •   l, left
    •   r, right

-m, --margin px
    Distance that window will keep from each anchor point respectively.

-M, --master
    Show a volume slider for the default audio sink.

-u, --userstyle file
    Specify path to userstyle. By default, mixxc will attempt to read style file from $XDG_CONFIG_HOME/mixxc, with priority for CSS supersets.
    •   .css
    •   .scss (Feature: Sass)
    •   .sass (Feature: Sass)

-x, --max-volume n
    Highest achievable volume level in percents. Minimum is 1. Default is 100. Maximum is 255.

-b, --bar orientation
    Changes orientation of audio sliders.
    •   h, horizontal
    •   v, vertical

-i, --icon
    Show icons that applications provide or display a generic reactive volume icon. If not all application icons are displayed properly, you might need to update icon cache gtk4-update-icon-cache(1) or update $XDG_DATA_DIRS.

-k, --keep
    Prevent window from closing itself. By default, window will be closed if focus is lost and mouse is no longer over it.

-v, --version
    Print version information.

--help
    Print help information.

ENVIRONMENT

PULSE_PEAK_RATE
    Integer value that controls frequency at which audio server probes audio tracks for loudness in an allowed dynamic range. Setting this value to 0 significantly reduces number of window redraws and CPU usage.

FILES
$XDG_CONFIG_HOME/mixxc/style.css
$XDG_CONFIG_HOME/mixxc/style.scss
$XDG_CONFIG_HOME/mixxc/style.sass

FEATURES
Here's a list of features that can be included or excluded at compile time. Excluding some of them might lead to a smaller binary size and performance improvements.

- Sass
Support for CSS supersets.

- X11
Support for X Window System.

- Wayland
Support for Wayland.

EXAMPLES
Open mixxc in the bottom right corner with some spacing.

    $ mixxc --anchor bottom	--margin 20 \
    	--anchor right	--margin 20

Using short options to switch to vertical slider orientation with icons, set width and height for each one of them.

    $ mixxc -b v -i -w 75 -h 350

If you don't need auto-closing - you can turn your custom made button into a switch.

    $ pkill mixxc | mixxc --keep

GTK4 supports multiple rendering backends which might improve startup time, memory usage or fix graphical glitches.

    $ GSK_RENDERER=help mixxc

AUTHORS
Elvyria <elvyria@tutanota.com>

BUGS

Firefox (123.0.1.1)

•   Muted playback removes audio sink and discards playback description information when unmuted.

•   Jumping to any part of playback results in `Remove <-> Create` request instead of `Modify`.

•   Volume levels are never requested from audio server, this causes desynchronization between volume levels.
These problems are exclusive to Firefox and do not appear under Chromium based browsers.