Minimalistic volume mixer.

Last update: Oct 23, 2023

Overview

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...

Termbox is a library that provides minimalistic API which allows the programmer to write text-based user interfaces.

1.9k Dec 22, 2022

Diamond is a minimalistic, powerful, and modern Javascript runtime that uses Deno_Core.

Diamond Diamond is a minimalistic, powerful, and modern Javascript runtime that uses Deno_Core. Installation Diamond is currently in beta(not even Alp

4 Aug 30, 2021

A minimalistic encryption protocol for rust async streams/packets, based on noise protocol and snow.

Snowstorm A minimalistic encryption protocol for rust async streams / packets, based on noise protocol and snow. Quickstart Snowstorm allows you to se

19 Nov 22, 2022

Talk with your machine in this minimalistic Rust crate!

Speak Speak is a simple, easy to use Natural Language Processor (NLP) written in Rust. Why use Speak? Speak uses a custom engine, and to setup you jus

15 Oct 11, 2022

A minimalistic implementation of Refal.

Refal A minimalistic implementation of Refal. It is based on the following (in Russian) papers by Sergei Romanenko: С.А.Романенко. Машинно-независимый

12 Apr 7, 2022

Minimalistic solana minter program if you don't want to use Metaplex

Minimalistic solana minter program The objective of this repository is to be only a minimalistic template for NFTs projects on Solana, so you can buil

23 Sep 6, 2022

A simple, single threaded and minimalistic port checker

1 Feb 12, 2022

mico (minimalistic config file format) encoder and decoder

mico This library implements a parser and emitter for mico (minimalistic config file format). Format example: Name: mico Description: minimalistic con

1 Jan 30, 2022

A fast and minimalistic image viewer forked from the now discontinued emulsion.

Alloy Image viewer based on (now-discontinued) Emulsion. Alloy targets Windows, Mac, and Linux (with more targets to come!). A note for Linux users: W

9 Dec 1, 2022

A minimalistic cross-platform malware scanner with non-blocking realtime filesystem monitoring using YARA rules.

Sauron is a minimalistic, YARA based malware scanner with realtime filesystem monitoring written in Rust. Features Realtime scan of created and modifi

155 Dec 26, 2022

Minimalistic EVM-compatible chain indexer.

EVM Indexer Minimalistic EVM-compatible blockchain indexer written in rust. This repository contains a program to index helpful information from any E

14 Dec 24, 2022

Minimalistic EVM-compatible chain indexer.

EVM Indexer Minimalistic EVM-compatible blockchain indexer written in rust. This repository contains a program to index helpful information from any E

11 Dec 15, 2022

Minimalistic implementation of entity kinds for Bevy ECS.

Bevy 💖 Kindly This crate is a minimalistic implementation of Kinded Entities for Bevy game engine. In summary, it allows the user to define, construc

10 Jan 26, 2023

Ember is a minimalistic Rust library for creating 2D graphics, games, and interactive visualizations with ease and simplicity.

Ember Ember is a simple and fun 2D rendering library for Rust, allowing you to quickly create graphics and interactive applications with ease. It uses

8 May 4, 2023

Minimalistic state machine for Bevy Game Engine.

🎚️ Moonshine Behavior Minimalistic state machine for Bevy game engine. Overview This crates is designed to provide a simple, stack-based, lightweight

3 May 4, 2023

ReefDB is a minimalistic, in-memory and on-disk database management system written in Rust, implementing basic SQL query capabilities and full-text search.

ReefDB ReefDB is a minimalistic, in-memory and on-disk database management system written in Rust, implementing basic SQL query capabilities and full-

75 Jun 12, 2023

Calc: A fully-featured minimalistic configurable calculator written in Rust

Calc Calc: A fully-featured minimalistic configurable rust calculator Install You can install the latest version from source git clone https://github.

4 Nov 15, 2023

A Minimalistic Rust library to extract all potential function selectors from EVM bytecode without source code.

EVM Hound A Minimalistic Rust library to extract all potential function selectors from EVM bytecode without source code. Installation $ cargo add evm_

34 Dec 3, 2023

Comments

How to build it with gtk4-layer-shell feature?

Hi, thanks for the interesting project!

I have issue building it on my Arch, here is what I tried:

git clone --depth 1 <repo>
cd mixxc

cargo build --release --features=Sass,Wayland

output:

   Compiling gdk4-sys v0.7.2
   Compiling gsk4-sys v0.7.3
   Compiling gtk4-sys v0.7.3
   Compiling gtk4-layer-shell-sys v0.1.2
The following warnings were emitted during compilation:

warning: `PKG_CONFIG_ALLOW_SYSTEM_CFLAGS="1" "pkg-config" "--libs" "--cflags" "gtk4-layer-shell-0" "gtk4-layer-shell-0 >= 1"` did not exit successfully: exit status: 1

error: failed to run custom build command for `gtk4-layer-shell-sys v0.1.2`

Caused by:
  process didn't exit successfully: `/tmp/cargo-installBvtVwJ/release/build/gtk4-layer-shell-sys-3911a91337e99d03/build-script-build` (exit status: 1)
  --- stdout
  cargo:rerun-if-env-changed=GTK4_LAYER_SHELL_0_NO_PKG_CONFIG
  cargo:rerun-if-env-changed=PKG_CONFIG_x86_64-unknown-linux-gnu
  cargo:rerun-if-env-changed=PKG_CONFIG_x86_64_unknown_linux_gnu
  cargo:rerun-if-env-changed=HOST_PKG_CONFIG
  cargo:rerun-if-env-changed=PKG_CONFIG
  cargo:rerun-if-env-changed=PKG_CONFIG_PATH_x86_64-unknown-linux-gnu
  cargo:rerun-if-env-changed=PKG_CONFIG_PATH_x86_64_unknown_linux_gnu
  cargo:rerun-if-env-changed=HOST_PKG_CONFIG_PATH
  cargo:rerun-if-env-changed=PKG_CONFIG_PATH
  cargo:rerun-if-env-changed=PKG_CONFIG_LIBDIR_x86_64-unknown-linux-gnu
  cargo:rerun-if-env-changed=PKG_CONFIG_LIBDIR_x86_64_unknown_linux_gnu
  cargo:rerun-if-env-changed=HOST_PKG_CONFIG_LIBDIR
  cargo:rerun-if-env-changed=PKG_CONFIG_LIBDIR
  cargo:rerun-if-env-changed=PKG_CONFIG_SYSROOT_DIR_x86_64-unknown-linux-gnu
  cargo:rerun-if-env-changed=PKG_CONFIG_SYSROOT_DIR_x86_64_unknown_linux_gnu
  cargo:rerun-if-env-changed=HOST_PKG_CONFIG_SYSROOT_DIR
  cargo:rerun-if-env-changed=PKG_CONFIG_SYSROOT_DIR
  cargo:warning=`PKG_CONFIG_ALLOW_SYSTEM_CFLAGS="1" "pkg-config" "--libs" "--cflags" "gtk4-layer-shell-0" "gtk4-layer-shell-0 >= 1"` did not exit successfully: exit status: 1
  error: could not find system library 'gtk4-layer-shell-0' required by the 'gtk4-layer-shell-sys' crate

  --- stderr
  Package gtk4-layer-shell-0 was not found in the pkg-config search path.
  Perhaps you should add the directory containing `gtk4-layer-shell-0.pc'
  to the PKG_CONFIG_PATH environment variable
  Package 'gtk4-layer-shell-0', required by 'virtual:world', not found
  Package 'gtk4-layer-shell-0', required by 'virtual:world', not found

warning: build failed, waiting for other jobs to finish...
error: failed to compile `mixxc v0.1.5`, intermediate artifacts can be found at `/tmp/cargo-installBvtVwJ`.
To reuse those artifacts with a future compilation, set the environment variable `CARGO_TARGET_DIR` to that path.

opened by murlakatamenka 2