From a64cb26cfed5b546682df2ad5b73b69cea3aa80f Mon Sep 17 00:00:00 2001 From: Pinapelz Date: Sun, 27 Sep 2026 22:17:34 -0700 Subject: add support for replaygain --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 5b97eb5..84c63d5 100644 --- a/README.md +++ b/README.md @@ -16,10 +16,13 @@ These are the rules that the CLI applies (can be OPTIONALLY applied from the GUI - Re-encodes files with block size higher than 4096 via `flac` CLI - Rename FLAC file to `TRACK_NAME - ARTIST.flac` - Resize embedded album art to 500x500px (good enough for small screen players, without taking up much space) -- Normalize all audio to -14 LUFS +- Normalize all audio to -14 LUFS (or, with `--replaygain`, write ReplayGain tags instead and leave the audio untouched) - Download LRC files (places them in same folder with same name, according to Snowsky Echo rules) - A delay of 0.3 sec is hardcoded to avoid rate limit, this is a hard limit across all threads (if running multithreaded) +> [!DANGER] +> Audio normalization is DESTRUCTIVE by default! This is because some DAPs do not support the ReplyGain tag. You can toggle ReplayGain by clicking the drop down under the "Echo Rules" button. + # External Dependencies You need the FLAC command line tool to be accessible globally, meaning it must be able to run anywhere on your machine. Using the official tool was the most consistent way of fixing the block-size issue cross-platform. @@ -38,12 +41,12 @@ uv sync **Apply Echo Rules:** ```bash -uv run expergo.py [--nolrc] [-n workers] +uv run expergo.py [--nolrc] [--replaygain] [-n workers] ``` **Subcommands:** ```bash -uv run expergo.py process [--nolrc] [-n workers] +uv run expergo.py process [--nolrc] [--replaygain] [-n workers] uv run expergo.py auto-lrc [--force] [-n workers] uv run expergo.py auto-cover [--force] [--tries N] [-n workers] uv run expergo.py reorg [--artist-only] [--no-cleanup] [-n workers] -- cgit v1.2.3