# Beets

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

## Installation

Install the beets package from the official repositories or beets-gitAUR from the AUR.

## 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.

Category:

- Multimedia