https://github.com/bhack/mini-eq
Compact PipeWire system-wide parametric EQ for Linux desktops
https://github.com/bhack/mini-eq
audio desktop-application equalizer flatpak gtk jack libadwaita linux parametric-eq pipewire python wireplumber
Last synced: about 1 month ago
JSON representation
Compact PipeWire system-wide parametric EQ for Linux desktops
- Host: GitHub
- URL: https://github.com/bhack/mini-eq
- Owner: bhack
- License: gpl-3.0
- Created: 2026-04-25T14:30:12.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-27T01:17:02.000Z (about 2 months ago)
- Last Synced: 2026-04-27T01:25:57.670Z (about 2 months ago)
- Topics: audio, desktop-application, equalizer, flatpak, gtk, jack, libadwaita, linux, parametric-eq, pipewire, python, wireplumber
- Language: Python
- Homepage: https://pypi.org/project/mini-eq/
- Size: 4.21 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Mini EQ
[](https://github.com/bhack/mini-eq/actions/workflows/ci.yml)
[](https://pypi.org/project/mini-eq/)
[](https://github.com/bhack/mini-eq/releases)
[](https://github.com/bhack/mini-eq/blob/main/LICENSE)
Mini EQ is a small system-wide parametric equalizer for PipeWire desktops.
It uses GTK/Libadwaita for the UI, pipewire-gobject for app-facing PipeWire
routing, metadata, and monitor streams, and PipeWire filter-chain with builtin
biquad filters for the equalizer. When libebur128 is available, the monitor can
also show live LUFS loudness.
## Features
- System-wide parametric EQ for PipeWire desktop playback.
- GTK/Libadwaita interface with a compact 10-band fader workflow.
- PipeWire routing and default-output tracking through pipewire-gobject.
- PipeWire filter-chain DSP using builtin biquad filters.
- Optional spectrum analyzer and LUFS loudness readout through a PipeWire monitor
capture stream.
- Auto preset links can follow the detected PipeWire port when available and
fall back to the selected EQ output when a port is not reported.
- Optional background mode keeps the EQ active after closing the window, with a
separate Start at Login preference and optional active-at-login routing.
- Optional GNOME Shell extension for quick panel access to routing, EQ,
analyzer status, presets, and auto preset links.
- Equalizer APO preset import from the UI or `--import-apo`, including
compatible presets exported by [AutoEq](https://autoeq.app/).
## AutoEq And APO Presets
Mini EQ can import Equalizer APO-style parametric EQ text presets. This makes it
usable with headphone correction presets exported by
[AutoEq](https://autoeq.app/): export an Equalizer APO/parametric EQ preset from
AutoEq, then use **Import Equalizer APO...** in Mini EQ or start the app with
`mini-eq --import-apo path/to/ParametricEQ.txt`. The
[AutoEq project](https://github.com/jaakkopasanen/AutoEq) provides the source,
headphone measurement data, targets, and optimizer behind the web app.
## Install
The recommended desktop install path is Flathub:
```bash
flatpak install flathub io.github.bhack.mini-eq
flatpak run io.github.bhack.mini-eq
```
PyPI and source installs are available for development or for systems with the
required GTK, Libadwaita, PyGObject, PipeWire, WirePlumber, and native
pipewire-gobject build/runtime packages already installed:
```bash
python3 -m pip install mini-eq
mini-eq --check-deps
mini-eq
```
See [Development](https://github.com/bhack/mini-eq/blob/main/docs/development.md)
for distro package names, PyPI virtualenv details, source checkout commands,
tests, and local Flatpak builds.
## GNOME Shell Extension
Mini EQ also has an optional GNOME Shell extension for quick panel access to
routing, EQ, analyzer status, presets, and auto preset links.
Install it from GNOME Shell Extensions:
https://extensions.gnome.org/extension/9803/mini-eq-controls/
## Notes
Runtime data is stored under `~/.config/mini-eq`.
`pip install mini-eq` installs only the Python package. The system packages
listed in
[Development](https://github.com/bhack/mini-eq/blob/main/docs/development.md)
are still required for the app to connect to GTK, PipeWire, and the host
WirePlumber-managed session.
## Acknowledgements
Mini EQ is inspired in part by [EasyEffects](https://github.com/wwmm/easyeffects)
and the broader [PipeWire](https://pipewire.org/) audio tooling ecosystem.
Mini EQ is a separate project focused on a compact system-wide parametric EQ
workflow.