drRoon

drRoon is a Python script that automatically tags audio files and albums with Dynamic Range (DR) ratings extracted from foobar2000 dynamic range log files.

This script is particularly useful for Roon users who want to organize and display the more commonly used dynamic range information in their music libraries, as opposed to the R128 method Roon natively uses.

Personally, I wanted to differentiate between different releases of the same album, to see at a glance how compressed a modern remaster might be compare to an original CD, for instance.

Features

Recursively processes directories to find foo_dr.txt files
Optionally renames album folders with DR values
Optionally tags album files with DR values
Supports MP3, FLAC, M4A (AAC / Apple Lossless), and DSF tagging
Ability to mark processed folders to avoid re-processing the same albums

Prerequisites

Python 3.6 or higher

Installation

Clone this repository or download the script:

git clone https://github.com/xportz/drRoon.git
cd drRoon

Install the required dependencies:
```
pip install mutagen
```

Usage

Run the script from the command line, providing the root directory to process:

python drRoon.py /path/to/music/library

Or on Windows:

python drRoon.py "C:\Path To\Music Library"

The above command will interactively ask you how you'd like to tag your albums. Alternatively, you can specify your choices from the command line, as follows:

usage: drRoon.py [-h] [--folder-score {0,1}] [--metadata {0,1,2,3}] [--rename-logfile {0,1}] [--find-missing] root_dir

Process DR values in audio files and directories.

positional arguments:
  root_dir              Root directory to process

options:
  -h, --help            show this help message and exit
  --folder-score {0,1}  Add DR score to album folder name (0: No, 1: Yes)
  --metadata {0,1,2,3}  Add DR score to metadata (0: No, 1: Both VERSION and ROONALBUMTAG, 2: VERSION only, 3: ROONALBUMTAG only)
  --rename-logfile {0,1}
                        Rename foo_dr.txt after processing (0: No, 1: Yes)
  --find-missing        Find folder albums missing the required log files

Options

When running the script, you'll be prompted with several options:

Album Folder Renaming
- Choose whether to add the DR score to the album folder name
- Example: "2024 - Album Title" → "2024 - Album Title (DR 10)"
Metadata Tagging
- Choose how to tag the audio files with DR information:
  - Both VERSION and ROONALBUMTAG tags
  - VERSION tag only
  - ROONALBUMTAG tag only
  - No tagging
- Any pre-existing (non DR) tags are retained
Log File Management
- Choose whether to rename foo_dr.txt to foo_dr_processed.txt after successful processing, so the same albums are not re-tagged

Find Missing Log Files

A "--find-missing" option has been added to recursively check the provided folder for missing log files. This is handy if you've added new albums to your library but haven't generated their foo_dr.txt log files yet. It simply checks each album folder for either a foo_dr.txt or foo_dr_processed.txt file and if not found, reports back to you.

Supported File Formats

MP3
FLAC
M4A (AAC / Apple Lossless)
DSF

How It Works

The script walks through the specified directory and its subdirectories.
It looks for foo_dr.txt files, which contain the album DR information.
When found, it extracts the DR value and tags the corresponding audio files and/or folder according to the chosen options.
Depending on the settings, it can:
- Rename the album folder to include the DR value
- Add DR information to the audio file metadata
- Mark the log file as processed so the album is ignored on future runs of the script

Notes

The script uses the mutagen library to handle audio file metadata.
It's recommended to backup your music library before running this script. Alternatively, it's recommended to test it on a small subset of your music library before running it against your entire music library. For instance, you can try copying a few albums to a test folder and run it against those to see how it operates.
Existing VERSION and ROONALBUMTAG tags are now retained and appended to instead of replaced. If a DR value is already present it is updated, if necessary, otherwise it is skipped.

Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.