OpenBSD Handbook

Current snapshot · amd64 · Generated 2026-09-16

beets-2.14.0

CLI tools to manage music collections

Project homepage: https://beets.io/

Description

The purpose of beets is to get your music collection right once and for all. It catalogs your collection, automatically improving its metadata as it goes using the MusicBrainz database. Then it provides a bouquet of tools for manipulating and accessing your music. If you plan to use plugins, please make sure that you have all necessary dependencies installed. Features include: - Fetch or calculate metadata: album art, lyrics, genres, tempos, ReplayGain levels, or acoustic fingerprints. - Get metadata from MusicBrainz, Discogs, or Beatport. Or guess metadata using songs' filenames or their acoustic fingerprints. - Transcode audio. - Check your library for duplicate tracks and albums or for albums that are missing tracks. - Browse your music library graphically through a Web browser and play it in any browser that supports HTML5 Audio.

Package information

Ports path
audio/beets
Package architecture
amd64
Maintainer
Kirill A. Korinsky <kirill@korins.ky>
Categories
audio, lang/python
Available flavors
None listed
Only for architectures
aarch64, amd64, arm, i386, mips64, mips64el, powerpc, powerpc64, riscv64, sparc64, alpha, hppa

These are ports metadata. Binary availability depends on the release, architecture and mirror. Build and test dependencies are not an installation checklist.

Direct dependencies

Runtime

Build

Test

OpenBSD README
+-----------------------------------------------------------------------
| Running beets on OpenBSD
+-----------------------------------------------------------------------

Optional plugins
================
This package includes several optional plugins for beets; they need to be
enabled by adding the name to the 'plugins:' line in your config.yaml file,
and many require additional packages to be installed.

Here are a few common examples.

discogs: The discogs plugin extends the autotagger's search capabilities
to include matches from the Discogs database. Add 'discogs' to the plugins:
line in ~/.config/beets/config.yaml. You will need to login and obtain an
OAuth token for Discogs; if updating from an older version and this no
longer works, you may need to "rm ~/.config/beets/discogs_token.json"
and login again.

replaygain: This plugin adds support for ReplayGain, a technique for
normalizing audio playback levels. It requires dependencies:
"pkg_add py3-gstreamer1 gst-plugins-good".
Edit ~/.config/beets/config.yaml - add 'replaygain' to the plugins:
line, and add the following:

replaygain:
    backend: gstreamer

web: The web plugin lets your browse and listen to your library through
an HTML5 compatible browser. Install the py3-flask package and add 'web'
to the plugins: line.

keyfinder: The keyfinder plugin detects the musical key of a track and
stores it in the initial_key field of your database. It requires dependencies:
"pkg_add keyfinder-cli".
Edit ~/.config/beets/config.yaml - add 'keyfinder' to the plugins:
line, and add the following:

keyfinder:
    bin: keyfinder-cli

See https://beets.readthedocs.io/en/latest/plugins/ for a complete list.

Package guides

Package details as JSON