From ArchWiki
Jump to navigation Jump to search

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


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


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:

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


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:

eval "$(beet completion)"

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