Beets

From ArchWiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Beets is a music tagger and library organizer using the MusicBrainz database.

Installation

Install the beets package or beets-gitAUR from the AUR for the development version.

Configuration

Tip: Beets provides a command for configuration manipulations. To edit the configuration file, run beet config -e. It will be opened with the text editor specified in the environment variable EDITOR.

User configuration is done in ~/.config/beets/config.yaml using YAML syntax. For example:

~/.config/beets/config.yaml
directory: ~/Music            # The default library root directory.
library: ~/Music/library.db   # The default library database file to use.

Usage

Add music

Add music to your library and attempt to fix tags:

$ beet import <path>

Add the single track without an album:

$ beet import -s <path>

List music

List all music in your library:

$ beet ls

List all albums in your library:

$ beet ls -a

Remove music

Tip: If you remove music from your filesystem or do any changes to the files without using beet, do not forget to run beet upd to update your library database.

Remove track(s) from your library:

$ beet rm <part of name>

Remove album(s) from your library:

$ beet rm -a <part of name>

Tips and tricks

Enabling tab-completion in bash

Beets includes support for Bash shell command completion. To enable completion, put the following line into your .bashrc:

~/.bashrc
eval "$(beet completion)"

You will also need to install bash-completion for this to work.