1
0
Fork
You've already forked drmeter
0
forked from janw/drmeter
Dynamic Range (DR) meter
  • Python 96.1%
  • Dockerfile 3.9%
2026年03月07日 17:16:08 +00:00
.forgejo/workflows fix(ci): populate release notes body properly 2026年03月07日 18:13:28 +01:00
drmeter build(ci): Update workflows 2026年03月06日 15:36:33 +01:00
tests Replace black with ruff format 2023年11月03日 14:04:37 +01:00
.dockerignore Add docker build 2023年07月26日 22:36:59 +02:00
.gitignore Add docker build 2023年07月26日 22:36:59 +02:00
.pre-commit-config.yaml build(ci): Update workflows 2026年03月06日 15:36:33 +01:00
CHANGELOG.md bump: version 0.4.8 → 0.4.9 2026年03月07日 17:16:08 +00:00
codecov.yml build: Add codecov config 2024年10月12日 13:44:21 +02:00
Dockerfile fix(docker): Restore docker build 2026年03月06日 15:43:49 +01:00
LICENSE Refresh repo scaffolding 2023年07月16日 23:12:24 +02:00
pyproject.toml bump: version 0.4.8 → 0.4.9 2026年03月07日 17:16:08 +00:00
README.md build(ci): Update workflows 2026年03月06日 15:36:33 +01:00
tox.toml build(ci): Update workflows 2026年03月06日 15:36:33 +01:00
uv.lock bump: version 0.4.8 → 0.4.9 2026年03月07日 17:16:08 +00:00

Dynamic Range (DR) meter 🎧

The algorithm has been reverse-engineered using the available information and officially endorsed software to calcuate the DR value. The analysis results of drmeter are verified to be within a ±0.5 absolute tolerance from the results produced by officially endorsed software (see #testing).

This project is in no way affiliated with the Pleasurize Music Foundation or its Dynamic Range Project.

Installation

The recommended method for using drmeter is with uv and uvx specifically:

uvx drmeter --help

Any regular pip install drmeter will do, too.

There is also a container image available at codeberg.org/janw/drmeter:

docker run --rm --tty --workdir /src -v "$PWD:/src" \
 codeberg.org/janw/drmeter --output json path/to/files

Usage

See drmeter --help for usage instructions. drmeter expects a single path to a file or a directory to analyze, and defaults to an "animated" progress display, emitting the results to stdout in the process.

$ drmeter 'Nobody There (Beautiful Scars).wav'
Analyzing Dynamic Range of Nobody There (Beautiful Scars).wav ...
╭──────────────────────────────────────────────────────────────────────╮
│ DR Peak RMS Filename │
├──────────────────────────────────────────────────────────────────────┤
│ DR12 -0.10 dB -15.02 dB Nobody There (Beautiful Scars).wav │
╰──────────────────────────────────────────────────────────────────────╯

Using the --quiet/-q flag will silence most of the output and only print the calculated DR score to stdout:

$ drmeter 'Nobody There (Beautiful Scars).wav' -q
DR12

Alternatively drmeter supports a more detailed JSON-formatted output using the --output/-o json parameter, including both per-channel and totaled results. Using the --output parameter redirects the progress display to stderr, so that the formatted output can be piped to other applications or to file. If you do not require the progress display, it can be silenced using --quiet/-q here, too.

# Save a copy to file
$ drmeter -ojson -q 'Nobody There (Beautiful Scars).wav' | tee dr.json
{
 "filename": "/.../Nobody There (Beautiful Scars).wav",
 "dr_score": [
 11.93,
 11.63
 ],
 "peak_db": [
 ...
 ]
}

# Parse JSON using jq
$ drmeter -ojson -q 'Nobody There (Beautiful Scars).wav' | jq '.[].overall_dr_score'
11.78