← Home

Three methods — all save instantly to the database and the file's POPM tag:

1. Library View — Click stars in the Rating column (track doesn't need to be playing)
2. Now Playing strip — Click stars in the toolbar while a track is playing
3. Global keyboard shortcuts — META+1 through META+5 (see Desktop Integration below)
4. Dolphin — Right-click any audio file → Rate Track → pick stars

Kid3's config is auto-synced to match your POPM values on every rating operation.

Always use Add New Tracks — never copy files to your library manually.

1. Place the album in your download directory (one artist/album at a time)
2. Open the album in Kid3 — verify the Artist and Album tags (Album tag determines the destination folder name)
3. Maintenance Panel → Add New Tracks → enter artist name → Execute

MusicLib normalizes filenames (Pink Floyd → pink_floyd), creates MUSIC_REPO/artist/album/, and adds tracks to the database.

Note: Conform Tags reads from musiclib.dsv but never writes back to it. Don't run it after a manual Kid3 edit — it will overwrite your changes. Use the Edit Field workflow instead.

MusicLib lives in the system tray. Hover for now-playing info.

• Right-click: Library, Maintenance, Mobile, Settings, Quit

• Left-click: Rate Current Track, Edit in Kid3, Copy Filepath, Library Record

Configure via Settings → Advanced → GUI Behavior.

Installed automatically by musiclib-cli setup to ~/.local/share/kio/servicemenus/musiclib-rate.desktop.

• Rate Track → submenu ★ through ★★★★★ — calls musiclib-cli rate <n> <filepath> directly
• Works on any audio file without opening MusicLib

Set up via KDE Menu Editor (create entries pointing to musiclib-cli rate 1 through rate 5), then assign keys under System Settings → Keyboard → Shortcuts.

Works system-wide even when MusicLib window is closed.

MusicLib writes to ~/.local/share/musiclib/data/conky_output/: