beets(1)
Beets is a music library manager and tagger that organizes your music collection automatically.
Synopsis
beet [OPTION] COMMAND [ARGS]Description
Beets is a command-line music organization tool that automatically fetches metadata (artist, album, title, cover art) from music databases and renames/moves your music files into a consistent directory structure. It uses fingerprinting technology to identify songs even without correct tags.
The tool manages a local music library database, allowing you to query, update, and manipulate your collection efficiently. It supports plugins for extended functionality like converting formats, fetching lyrics, and syncing with music services.
Common options
| Flag | What it does |
|---|---|
-l, --library | Specify a custom library database path |
-c, --config | Use a specific configuration file |
-d, --directory | Set the directory to manage as your music library |
-v, --verbose | Increase verbosity (can be repeated for more detail) |
-q, --quiet | Suppress informational output |
-h, --help | Show help message and exit |
--version | Show program version and exit |
Examples
Import and tag all music from the Downloads folder, interactively matching tracks
beet import ~/Downloads/musicImport music with automatic tagging (skip confirmation prompts when confident)
beet import -s ~/Downloads/musicShow all songs by The Beatles in your library
beet list artist:BeatlesModify tags for matching items (prompts for confirmation)
beet modify artist=Radiohead album=OK ComputerCopy music files to the configured library directory and reorganize them
beet move -cRemove tracks with 'Unknown' artist from the library (with confirmation)
beet remove artist:UnknownDisplay statistics about your music library (total tracks, albums, playtime)
beet statsOpen the configuration file in your default text editor
beet config -e