Peaceful

Peaceful reads PEACE / Equalizer APO .txt presets and builds Easy Effects output preset files for Linux (PipeWire). It only parses and writes JSON; it is not a full DSP engine.

Status: early MVP (0.1.x). Issues and PRs welcome.

What it does

• Reads Equalizer APO style Filter: / Preamp: lines (PK, LS, HS, LSC, HSC, and similar). Skips what it does not support.
• Reads a single-line GraphicEQ: preset (GraphicEQ: 20 1.5; 40 2.0; ...) like many AutoEq exports. That is converted to peaking bands (approximation, not identical to APO's GraphicEQ).
• Reads Peace FilterCurve: text (f0="Hz" v0="dB" ...) as peaking bands. That is an approximation of Peace's spline curve, not identical to Peace on Windows.
• Some .peace files are plain text (APO-style Filter lines inside); those work. Others are Peace-only or binary; use a .txt with APO text, GraphicEQ:, or FilterCurve: if import shows no bands.
• import: print JSON for debugging.
• apply: write peaceful_import.json (or another name) into Easy Effects' output preset folder.
• visualize: optional EQ curve plot (needs extra Python packages).

What you need

• Python 3.10+ on the machine where you run Peaceful.
• Linux + Easy Effects if you want to use apply and hear the EQ. Windows is fine for import, generating JSON, and visualize if you install the viz extras.

Repo: https://github.com/holykek/peaceful

Install on Linux

Easiest (recommended): install pipx, then:

pipx install "git+https://github.com/holykek/peaceful.git"

Graphs for visualize:

pipx inject peaceful numpy matplotlib

Without pipx: use a venv in your home directory:

python3 -m venv ~/peaceful-env
source ~/peaceful-env/bin/activate
python -m pip install "git+https://github.com/holykek/peaceful.git"
python -m pip install "peaceful[viz] @ git+https://github.com/holykek/peaceful.git"

Next time you open a terminal, run source ~/peaceful-env/bin/activate before peaceful.

If the command peaceful is missing: run python3 -m peaceful with the same arguments (or python -m peaceful inside the venv).

Arch / CachyOS example for pipx: sudo pacman -S python-pipx then pipx ensurepath and restart the terminal.

Install on Windows

1. Install Python 3.10+ from python.org. Enable Add python.exe to PATH in the installer.
2. Open PowerShell or Command Prompt and run:

py -m pip install --user "git+https://github.com/holykek/peaceful.git"

If py is not found, try python instead of py.

No Git installed? Use the zip URL instead:

py -m pip install --user "https://github.com/holykek/peaceful/archive/refs/heads/main.zip"

Graphs (visualize): after Peaceful is installed, add:

py -m pip install --user numpy matplotlib

If peaceful is not on PATH: always use:

py -m peaceful import --help

How to use

1. Test the preset file

peaceful import "C:\path\to\preset.txt" --pretty -v

On Linux use /home/you/... paths. Quotes matter if the path has spaces.

2. On Linux only: write the Easy Effects preset

peaceful apply "/path/to/preset.txt"

Default file: ~/.config/easyeffects/output/peaceful_import.json

In Easy Effects: Presets, Output, pick peaceful_import.

Flatpak Easy Effects often uses:

~/.var/app/com.github.wwmm.easyeffects/config/easyeffects/output/

Either:

export PEACEFUL_EASYEFFECTS_OUTPUT="$HOME/.var/app/com.github.wwmm.easyeffects/config/easyeffects/output"
peaceful apply "/path/to/preset.txt"

or:

peaceful apply "/path/to/preset.txt" -o "$HOME/.var/app/com.github.wwmm.easyeffects/config/easyeffects/output"

3. Windows PC, Linux audio (Easy Effects does not run on Windows)

Easy Effects is Linux-only. On Windows you can still build the preset JSON, then copy it to Linux.

peaceful apply "C:\path\to\preset.peace" --no-reload -o "C:\path\to\folder_for_linux"

That writes peaceful_import.json in that folder. Copy that file to Linux:

• ~/.config/easyeffects/output/ (typical install), or
• ~/.var/app/com.github.wwmm.easyeffects/config/easyeffects/output/ (Flatpak)

Then in Easy Effects: Presets, Output, choose peaceful_import. On Windows itself, keep using Peace / Equalizer APO for playback; Peaceful is for moving the curve to Linux.

4. Optional graph

peaceful visualize "/path/to/preset.txt"

-w reloads when the file changes on disk.

Useful flags for apply: --name mypreset, --no-reload, --rlc, -o DIR, -v, --no-subsample. See peaceful apply --help.

Limitations

• Easy Effects allows 32 EQ bands. If your file has more (for example a 50-point FilterCurve), peaceful apply picks 32 points log-spaced in frequency so export still works. Use --no-subsample if you want an error instead.
• Shelves and Q may not match Windows APO exactly. Default band mode is APO (DR); try --rlc if needed.
• OFF filters in the txt file are ignored.

Project layout

peaceful/   CLI, parser, Easy Effects converter, optional viz
examples/   sample_peace.txt

License

MIT. See LICENSE.