termusic

Terminal music player.

Runs as termusic|macOS, Linux, Windows|github.com

Command form

ai-draft · 1 task · 6 fields

Launch the termusic TUI on a music directory. Subcommands (playback control, podcasts, playlists) and logging options are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui termusic

Start the music playerExample values, fixed in this page — nothing here reaches a terminal

Basic

Music directory

directory

Hide album cover

--hide-cover

TasksEach one presets the form for one job

Start player

music_directoryhide_cover

ParametersOnly these flags are editable in the form

Music directory

Defaults to the directory in the config file, or ~/Music.
path · positional 0

Hide album cover

boolean

--hide-cover-c

Disable cover support

boolean

--disable-cover

Disable Discord presence

boolean

-d

Max folder depth

Default is 4.
integer

-m

Playback backend

Which backends exist depends on how termusic was built.
string

--backendrusty

SourcesEvery flag above is checked against these

changelog

- Change(tui): rename cli option `--disable-cover` to `--hide-cover`. - Feat(tui): add new cli option `--disable-cover` which actually disables all cover probing and behaves as if no cover features are enabled. - Feat(server): allow compiling multiple backends via features and select at binary start (via `--backend` or `TMS_BACKEND`). - New: add command lin…

manualmaster 2026-10-27

raw.githubusercontent.com

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