Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/janw/drmeter

Dynamic Range (DR) meter
https://github.com/janw/drmeter

audio-analysis dynamic-range loudness-war python

Last synced: 13 days ago
JSON representation

Dynamic Range (DR) meter

Host: GitHub
URL: https://github.com/janw/drmeter
Owner: janw
License: mit
Created: 2018-06-24T09:03:59.000Z (over 6 years ago)
Default Branch: main
Last Pushed: 2024-10-28T01:03:14.000Z (17 days ago)
Last Synced: 2024-10-28T04:59:14.282Z (17 days ago)
Topics: audio-analysis, dynamic-range, loudness-war, python
Language: Python
Homepage:
Size: 42.5 MB
Stars: 15
Watchers: 1
Forks: 0
Open Issues: 4
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

# Dynamic Range (DR) meter 🎧

[![Tests](https://github.com/janw/drmeter/actions/workflows/tests.yaml/badge.svg)](https://github.com/janw/drmeter/actions/workflows/tests.yaml)
[![Coverage Status](https://codecov.io/gh/janw/drmeter/branch/main/graph/badge.svg?token=N8DBXQTM74)](https://codecov.io/gh/janw/drmeter)
[![Docker](https://github.com/janw/drmeter/actions/workflows/docker-build.yaml/badge.svg)](https://github.com/janw/drmeter/pkgs/container/drmeter)

[![PyPI](https://img.shields.io/pypi/v/drmeter.svg)](https://pypi.org/project/drmeter/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/drmeter.svg)](https://pypi.org/project/drmeter/)
![PyPI - Downloads](https://img.shields.io/pypi/dm/drmeter)

[![Linter/Formatter: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://docs.astral.sh/ruff/)
[![Code style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://black.readthedocs.io/en/stable/)
[![Dependency management: poetry](https://img.shields.io/badge/deps-poetry-blueviolet.svg)](https://python-poetry.org/docs/)

A Dynamic Range (DR) analyzer for audiofiles.

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 installing `drmeter` is [pipx](https://pypa.github.io/pipx/):

```bash
pipx install drmeter
```

Any regular `pip install drmeter` will do, too. The `drmeter` requires Python 3.9+ to run.

To use `drmeter` without installation, consider the [dockerized approach](#dockerized) below

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

```sh
$ 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:

```sh
$ 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.

```sh
# 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": [
…
]
}
```

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

### Dockerized

A container image of `drmeter` is available at `ghcr.io/janw/drmeter` with the `latest` tag pointing to the latest commit on the `main` branch. The following command (with the files you're looking to analyze in/below the current working directory) behaves very similarly to an installed version, accepting arguments directly as expected:

```sh
docker run --rm --tty --workdir /src -v "$PWD:/src" \
ghcr.io/janw/drmeter --output json path/to/files
```