otty / apps
All apps/beets

beets

beets

The media library management system for obsessive music geeks.

Runs as beet|macOS, Linux, Windows|beets.io
Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 16 fields

Import music into the library and query it. Other beet subcommands and plugin options are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui beets

beet import

Import music

Import files or directories into the library. Archives, incremental and resume options are left out.

Import musicExample values, fixed in this page — nothing here reaches a terminal
Basic
Files or directories*
any
Preview only
--pretend
Quiet (no prompts)
-q
TasksEach one presets the form for one job
Import (copy files)
pathsquietpretend
ParametersOnly these flags are editable in the form
Move files instead of copying
boolean
-m
Don't copy files
boolean
-C
Don't write tags
boolean
-W
Don't autotag
boolean
-A
Quiet (no prompts)
boolean
-q
Timid (confirm every match)
boolean
-t
Import as singletons
boolean
-s
Flat (one album per directory)
boolean
--flat
Preview only
boolean
--pretend
Log skipped items to file
path
-l
Files or directories
path · positional 0 · repeatable

beet list

Query the library

List matching tracks or albums. Query syntax is passed through as typed.

Query the libraryExample values, fixed in this page — nothing here reaches a terminal
Basic
Query*
string
Albums instead of tracks
-a
TasksEach one presets the form for one job
Search
queryalbums
ParametersOnly these flags are editable in the form
Albums instead of tracks
boolean
-a
Print file paths
boolean
-p
Output format
Template such as '$album: $albumtotal'.
string
-f
Limit
integer
--limit-l
Query
string · positional 0 · repeatable
SourcesEvery flag above is checked against these
cli
beet import [-CMWAPRqst] [-l LOGPATH] PATH... the ``-m`` (move) option. ``-C`` (don't copy), ``-M`` (don't move), and ``-W`` (don't write tags) options. using ``-A`` (don't the ``-l`` option to the ``-q`` (quiet) option the ``-t`` (for *timid*) option. supplying the ``-s`` option. use the ``--flat`` option. use the ``--pretend`` ``--set field=value``
manualmaster 2026-10-27

beets.readthedocs.io

cli
beet list [-apf] [-l LIMIT] QUERY You can use the ``-a`` switch to search for albums instead of individual items. Use the ``-l LIMIT`` (``--limit=LIMIT``) flag The ``-p`` option makes beets print out filenames of matched items the ``-f`` option lets you specify a specific format
manualmaster 2026-10-27

beets.readthedocs.io

Before it fills your prompt, Otty checks the installed beet against its version. A form that does not match your version is not offered.