Ubuntu Manpage: beet - music tagger and library organizer

NAME

       beet - music tagger and library organizer

SYNOPSIS

       beet [args...] command [args...]
       beet help command

COMMANDS

import
beet import [-CWAPRqst] [-l LOGPATH] DIR...
beet import [options] -L QUERY

Add music to your library, attempting to get correct tags for it from MusicBrainz.

Point the command at a directory full of music. The directory can be a single album or a
directory whose leaf subdirectories are albums (the latter case is true of typical
Artist/Album organizations and many people's "downloads" folders). The music will be
copied to a configurable directory structure (see below) and added to a library database
(see below). The command is interactive and will try to get you to verify MusicBrainz tags
that it thinks are suspect. (This means that importing a large amount of music is
therefore very tedious right now; this is something we need to work on. Read the
autotagging guide if you need help.)

• By default, the command copies files your the library directory and updates the ID3 tags
on your music. If you'd like to leave your music files untouched, try the -C (don't
copy) and -W (don't write tags) options. You can also disable this behavior by default
in the configuration file (below).

• Also, you can disable the autotagging behavior entirely using -A (don't autotag)---then
your music will be imported with its existing metadata.

• During a long tagging import, it can be useful to keep track of albums that weren't
tagged successfully---either because they're not in the MusicBrainz database or because
something's wrong with the files. Use the -l option to specify a filename to log every
time you skip an album or import it "as-is" or an album gets skipped as a duplicate.

• Relatedly, the -q (quiet) option can help with large imports by autotagging without ever
bothering to ask for user input. Whenever the normal autotagger mode would ask for
confirmation, the quiet mode pessimistically skips the album. The quiet mode also
disables the tagger's ability to resume interrupted imports.

• Speaking of resuming interrupted imports, the tagger will prompt you if it seems like
the last import of the directory was interrupted (by you or by a crash). If you want to
skip this prompt, you can say "yes" automatically by providing -p or "no" using -P. The
resuming feature can be disabled by default using a configuration option (see below).

• If you want to import only the new stuff from a directory, use the -i option to run an
incremental import. With this flag, beets will keep track of every directory it ever
imports and avoid importing them again. This is useful if you have an "incoming"
directory that you periodically add things to. To get this to work correctly, you'll
need to use an incremental import every time you run an import on the directory in
question---including the first time, when no subdirectories will be skipped. So consider
enabling the incremental configuration option.

• By default, beets will proceed without asking if it finds a very close metadata match.
To disable this and have the importer ask you every time, use the -t (for timid) option.

• The importer typically works in a whole-album-at-a-time mode. If you instead want to
import individual, non-album tracks, use the singleton mode by supplying the -s option.

• If you have an album that's split across several directories under a common top
directory, use the --flat option. This takes all the music files under the directory
(recursively) and treats them as a single large album instead of as one album per
directory. This can help with your more stubborn multi-disc albums.

list
beet list [-apf] QUERY

Queries the database for music.

Want to search for "Gronlandic Edit" by of Montreal? Try beet list gronlandic. Maybe you
want to see everything released in 2009 with "vegetables" in the title? Try beet list
year:2009 title:vegetables. (Read more in query.)

You can use the -a switch to search for albums instead of individual items. In this case,
the queries you use are restricted to album-level fields: for example, you can search for
year:1969 but query parts for item-level fields like title:foo will be ignored. Remember
that artist is an item-level field; albumartist is the corresponding album field.

The -p option makes beets print out filenames of matched items, which might be useful for
piping into other Unix commands (such as xargs). Similarly, the -f option lets you specify
a specific format with which to print every album or track. This uses the same template
syntax as beets' path formats. For example, the command beet ls -af '$album: $tracktotal'
beatles prints out the number of tracks on each Beatles album. In Unix shells, remember to
enclose the template argument in single quotes to avoid environment variable expansion.

remove
beet remove [-ad] QUERY

Remove music from your library.

This command uses the same query syntax as the list command. You'll be shown a list of
the files that will be removed and asked to confirm. By default, this just removes
entries from the library database; it doesn't touch the files on disk. To actually delete
the files, use beet remove -d.

modify
beet modify [-MWay] QUERY FIELD=VALUE...

Change the metadata for items or albums in the database.

Supply a query matching the things you want to change and a series of field=value pairs.
For example, beet modify genius of love artist="Tom Tom Club" will change the artist for
the track "Genius of Love." The -a switch operates on albums instead of individual
tracks. Items will automatically be moved around when necessary if they're in your library
directory, but you can disable that with -M. Tags will be written to the files according
to the settings you have for imports, but these can be overridden with -w (write tags, the
default) and -W (don't write tags). Finally, this command politely asks for your
permission before making any changes, but you can skip that prompt with the -y switch.

move
beet move [-ca] [-d DIR] QUERY

Move or copy items in your library.

This command, by default, acts as a library consolidator: items matching the query are
renamed into your library directory structure. By specifying a destination directory with
-d manually, you can move items matching a query anywhere in your filesystem. The -c
option copies files instead of moving them. As with other commands, the -a option matches
albums instead of items.

update
beet update [-aM] QUERY

Update the library (and, optionally, move files) to reflect out-of-band metadata changes
and file deletions.

This will scan all the matched files and read their tags, populating the database with the
new values. By default, files will be renamed according to their new metadata; disable
this with -M.

To perform a "dry run" of an update, just use the -p (for "pretend") flag. This will show
you all the proposed changes but won't actually change anything on disk.

When an updated track is part of an album, the album-level fields of all tracks from the
album are also updated. (Specifically, the command copies album-level data from the first
track on the album and applies it to the rest of the tracks.) This means that, if
album-level fields aren't identical within an album, some changes shown by the update
command may be overridden by data from other tracks on the same album. This means that
running the update command multiple times may show the same changes being applied.

stats
beet stats [-e] [QUERY]

Show some statistics on your entire library (if you don't provide a query) or the matched
items (if you do).

The -e (--exact) option makes the calculation of total file size more accurate but slower.

fields
beet fields

Show the item and album metadata fields available for use in query and pathformat.
Includes any template fields provided by plugins.

GLOBAL FLAGS

       Beets  has  a  few  "global" flags that affect all commands. These must appear between the
       executable name (beet) and the command: for example, beet -v import ....

       • -l LIBPATH: specify the library database file to use.

       • -d DIRECTORY: specify the library root directory.

       • -v: verbose mode; prints out a deluge of debugging information.  Please  use  this  flag
         when reporting bugs.

AUTHOR

       Adrian Sampson

COPYRIGHT