Skip to content

Home

Jump to bottom
lpcornel edited this page May 13, 2026 · 4 revisions

MusicLib Wiki

Version 1.70 · Linux · KDE Plasma 6

MusicLib is a music library management hub for KDE Plasma 6. It sits between you and your audio player — handling ratings, playback tracking, smart playlists, mobile sync, CD ripping, and KDE integration while your player does the actual playing.

MusicLib main window screenshot

Quick Links

Topic Page
Install dependencies and build from source Installation
First-time setup and database build Setup
GUI panels, toolbar, rating tracks Using-the-GUI
CLI commands and options CLI-Reference
Smart playlist algorithm and tuning Smart-Playlist
Mobile sync via KDE Connect Mobile-Sync
Troubleshooting, FAQ, tips Troubleshooting

What MusicLib Does

Feature Details
Rate & organize 0–5 star ratings saved to both the database and the file's POPM tag
Track playback LastTimePlayed logged for desktop (any MPRIS2-compatible player) and mobile devices
Smart playlists Variety-optimized; weighted by rating, age, and artist exclusion window
Mobile sync Pushes playlists + files to Android/iOS via KDE Connect
CD ripping Manages K3b's rip profile (format, bitrate, error correction)
Tag management Cleans, conforms, and rebuilds ID3 tags from the database
KDE integration System tray, Dolphin context menu ratings, global shortcuts, Conky output

What MusicLib Does NOT Do

  • Play music (use any MPRIS2-compatible player: Audacious, Strawberry, Clementine, etc.)
  • Stream from Spotify, Apple Music, or any online service
  • Auto-fetch metadata from the internet
  • Run without KDE Plasma 6 or on non-Linux systems
  • Log more than one mobile playlist at a time

Architecture & Features at a Glance

MusicLib main window screenshot

  • Database: ~/.local/share/musiclib/data/musiclib.dsv — plain ^-delimited text, one row per track
  • Config: ~/.config/musiclib/musiclib.conf
  • Logs: ~/.local/share/musiclib/logs/
  • Playlists: ~/.local/share/musiclib/playlists/

Supported Distributions

Any Linux distro running KDE Plasma 6. Tested on: Arch, Fedora KDE, Ubuntu/Kubuntu, KDE Neon, openSUSE, Debian.

Full Documentation

The complete step-by-step manual is in the repository: 📄 MUSICLIB_USER_MANUAL.md

This wiki is a quick reference. For detailed procedures, refer to the manual.

Clone this wiki locally