Quod Libet: a local music library manager for Linux, Windows, and macOS

A single desktop surface for local audio collections

Quod Libet addresses people who keep music on a local disk and need more than a basic playback list. The README describes it as a cross-platform audio and music management program. Its scope covers several tasks that are often split across separate tools: playing audio, viewing libraries, editing tags, searching metadata, following podcast feeds, and handling streaming audio.

The repository contains the main Quod Libet application and a related Ex Falso application. Ex Falso is described as a bare-bones tag editor that uses the same editing interface as Quod Libet. That division matters for adoption. Users who mainly need to correct metadata can consider Ex Falso rather than treating the full player as the only entry point.

The README also says that Quod Libet includes more than 90 plugins and that additional plugins can be written in Python. This makes the project relevant to users who want to connect local audio workflows with other services or add specialized behavior. The `pyproject.toml` file identifies Quod Libet as a music library, tagger, and player. Its package metadata lists Python 3.10 or newer as the supported interpreter range, with Python 4 excluded by the upper bound.

The project is desktop-oriented rather than a documented library service. The repository does not describe a server mode, a database server, or a headless API for managing a shared collection. It does list command-line entry points, including `operon`, `quodlibet-cmd`, and `exfalso-cmd`, but the README does not explain their full operational use. The practical fit is strongest for an individual user or workstation managing files that are already available locally.

Library views, metadata editing, feeds, and plugin entry points

The visible design is a feature-oriented desktop application. Quod Libet provides multiple ways to view local libraries, while its metadata system supports flexible editing and searching. The README does not document the internal library schema, indexing process, or query language, so those implementation details should not be inferred from the project description. What can be established is that library organization and tag-based discovery are treated as core functions rather than accessories.

The application also supports streaming audio and podcast feeds. `feedparser` is a declared Python dependency, with a version range of `>=6.0.11,<7.0.0`. On macOS, the package metadata includes `pyobjc-framework-mediaplayer` and `certifi` through platform-specific dependencies. These entries show that playback support has platform-dependent components, although the repository does not explain how playback is selected or how certificates are configured.

Metadata work is a major part of the product. `mutagen>=1.45,<2.0` is a required dependency, and the README explicitly calls out flexible metadata editing and searching. Ex Falso reuses the same editing interface, which indicates that tag editing is separated from the player experience enough to serve users who do not want the full library-management feature set.

Plugins form the extension mechanism. The README says that users can extend and integrate Quod Libet with external services and write plugins in Python. The optional `plugins` dependency group includes `musicbrainzngs`, `dbus-python` on Linux, `soco`, `pypresence`, `regex`, and `paho-mqtt`. The repository also points to dedicated plugin-development documentation. The exact plugin loading rules, compatibility guarantees, and sandboxing model are not documented in the README, so they should be checked before depending on a particular integration.

Installing Quod Libet and starting the documented entry points

The README directs users to the development documentation for building, installing, and testing Quod Libet and Ex Falso. The repository’s `pyproject.toml` provides concrete commands for installing the project and its optional plugin dependencies. These commands are suitable as a development-oriented first path. The README does not provide a complete operating-system installation tutorial or a packaged installer walkthrough.

From a checkout, the optional dependency group can be installed with Poetry. The command below comes directly from the package metadata. It installs the project with the dependencies listed for the `plugins` extra.

poetry install -E plugins

After that, the package metadata documents a command that runs the application without passing CLI arguments:

poetry run quodlibet

That should be the first application command to consult because it starts the main Quod Libet program. For metadata-focused use, the project also defines `exfalso-cmd` as a command-line entry point. The package metadata does not document its arguments or options, so it should be invoked without assuming flags.

exfalso-cmd

For GUI use, `pyproject.toml` declares `quodlibet` and `exfalso` under `[project.gui-scripts]`. Whether these commands are available depends on how the package is installed and on the desktop environment. The repository also lists `operon` as a console script, but it does not explain what operational features it exposes. The official development overview and user guide are the authoritative places to confirm prerequisites, platform-specific setup, and first-run behavior.

Library management limits and metadata risks

Quod Libet has a broad scope, but the README leaves several adoption questions unanswered. It does not state how large a music library the application is intended to handle, how library changes are detected, or whether database rebuilds are manual or automatic. It also does not document a rollback procedure for metadata changes or a command for repairing a damaged library. That absence matters because a tagger can alter files in place, and users should know how a mistaken bulk edit can be inspected or reversed.

The README does not provide a detailed compatibility matrix for audio formats, codecs, streaming services, or podcast providers. The package metadata confirms several dependencies and platform-specific packages, but dependency names alone do not guarantee that every service or format is available on every operating system. Users should consult the user guide for the exact playback and feed behavior relevant to their files.

Quod Libet is also not the right tool when the requirement is a deliberately small tag editor. Ex Falso is the repository’s explicit alternative for that narrower goal. Conversely, Ex Falso does not replace the full player if the requirement is local-library browsing, playback, podcast feeds, and plugin integration in one application. The distinction should be made before installation because both applications share package infrastructure and the same editing interface.

Quod Libet versus Ex Falso and a conventional player

The most concrete alternative documented by the project is Ex Falso. Quod Libet is the broader application, combining a player, library manager, metadata editor, feed reader, and streaming client. Ex Falso narrows the interface to tag editing while retaining the same editing experience. A user whose main problem is correcting inconsistent tags can avoid evaluating the extra library and playback features. A user who needs browsing and playback should evaluate Quod Libet itself.

Compared with a conventional music player, Quod Libet places library management and metadata search at the center of the product description. A conventional player may focus on playback queues and a smaller media view, while Quod Libet is explicitly designed around managing a local audio collection and editing its metadata. The project also supports plugins written in Python, whereas the README does not establish that a conventional player offers the same extension boundary.

Compared with a standalone tag editor, Quod Libet adds more responsibilities and therefore more platform and configuration questions. The Python dependency set includes GTK-related `pygobject`, Cairo, Mutagen, and feed parsing components, with additional packages selected by platform. Ex Falso is the cleaner choice when those extra playback and library-management facilities are unnecessary. The README does not provide a feature-by-feature comparison table, so selection should be based on the user’s primary task rather than assumptions about feature depth.

Maintenance, licensing, and upgrade cost

The repository is not archived, and its last push was on 2026-10-05. That establishes current repository activity, but it does not by itself describe the release cadence or guarantee long-term compatibility. The listed releases include `release-4.7.1` from 2025-05-31, while the development metadata in `pyproject.toml` identifies the project version as `4.7.0-pre`. The difference between a development version and a listed release is relevant when evaluating upgrade expectations.

The package is licensed under `GPL-2.0-or-later` according to `pyproject.toml`. The repository also contains `COPYING` and GPL-related licensing text in `setup.py`. Users who distribute a modified build, bundle it with other software, or provide it as part of a product should review the license text and comply with its terms. This is a licensing note rather than legal advice, and the project-specific license files are the starting point for that review.

Maintenance work can affect both the application and its collection. Python requirements are declared as `>=3.10,<4.0`, and the plugin extra contains packages constrained to particular version ranges. Some optional dependencies are conditional by platform, including `pyobjc-framework-mediaplayer` on macOS and `dbus-python` on Linux. Upgrading the application, Python, or plugin dependencies may therefore require platform-specific checks. The repository does not document a formal migration policy for library databases or metadata changes, so users should preserve their own backups before adopting a new release.

Editorial conclusion

Quod Libet fits users who want a desktop player and detailed local-library management in one application, especially those willing to work with a Python and GTK-oriented project. It is less suitable for people seeking a minimal metadata editor, a server-side library service, or a documented headless automation workflow. Before adopting it, verify the build instructions for the intended operating system, confirm that the required Python version is available, and decide whether the plugin surface is useful for your collection. Its GPL-2.0-or-later license also needs review against the distribution and modification requirements that apply to your use.

Frequently asked questions

Official sources

1. License: GPL-2.0
2. Project website
3. quodlibet/quodlibet on GitHub
4. README
5. Releases