beetbox / beetbox/beets

Deprecate `format_raw_length`

Open
#6,018 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
15.7k
Forks
2.1k
Avg merge
4d 21h
Merged PRs (30d)
31

Description

The `format_raw_length` option was introduced in 2015 (beets 1.3.16) to maintain backwards compatibility when the at this point new `DurationType` began displaying track lengths as MM:SS instead of raw seconds. This gave users a way to preserve the old behavior.

Today, however, the option is effectively undocumented, mentioned only once in the changelog, and has little practical use. The `beet list length:*` command already accepts both raw seconds and duration strings, and users who need unformatted values can access the raw length field directly. This makes the config option redundant.

A reasonable path forward would be to deprecate `format_raw_length`, warning users if it appears in configuration files, and then remove it entirely in version `3.0.0`.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.