QUODLIBET(1)

💖 QUODLIBET(1) — the quodlibet manual, but make it cute 💖

okay bestie, sit down, grab a strawberry 🍓, because we're about to talk about quodlibet — the manual page for it anyway. (Yes, the manpage name is literally QUODLIBET(1), iykyk.)

---

✨ NAME ✨

quodlibet — audio library manager and player 🎵

🌸 SYNOPSIS 🌸

quodlibet [ --print-playing | control ]
exfalso [ directory ]

🎀 DESCRIPTION 🎀

Quod Libet is a music management program. It gives you several different ways to look at your audio library, plus support for Internet radio and audio feeds. And the metadata tag editing and searching? extremely flexible. It's giving ✨main character✨ fr fr.

Heads up bestie: this manual page is only a short reference for Quod Libet. The complete documentation lives at https://quodlibet.readthedocs.io/en/latest/guide/index.html 💅

💅 OPTIONS 💅

okay so this is the long part but every single one matters, no skipping, periodt.

• --add-location=<location> — add a file or directory to the library 📁
• --debug — print debugging information 🐛
• --enqueue=<filename|query> — enqueue a filename or query results
• --enqueue-files=<filename[,filename..]> — enqueue comma-separated files
• --filter <tag=value> — filter on a tag value
• --focus — focus the running player 👀
• --force-previous — jump to previous song
• --help — display brief usage information
• --hide-window — hide main window
• --list-browsers — list available browsers
• --next — jump to next song ⏭️
• --no-plugins — start without plugins
• --open-browser=BrowserName — open a new browser
• --pause — pause playback ⏸️
• --play — start playback ▶️
• --play-file=filename — play a file
• --play-pause — toggle play/pause mode
• --previous — jump to previous song if near the beginning, otherwise restart
• --print-playing — print out information about the currently playing song. You may provide in a string like the kind described in the RENAMING FILES section below.
• --print-playlist — print the current playlist
• --print-query=<query> — print filenames of results of query
• --print-query-text — print the active text query
• --print-queue — print the contents of the queue
• --query=search-string — search your audio library 🔍
• --queue=<on|off|t> — show or hide the queue
• --quit — exit Quod Libet
• --random=tag — filter on a random value 🎲
• --rating=<[+|-]0.0..1.0> — set rating of playing song ⭐
• --rating-down — decrease rating of playing song by one star
• --rating-up — increase rating of playing song by one star
• --refresh — refresh and rescan library 🔄
• --repeat=<off|on|t> — turn repeat off, on, or toggle
• --repeat-type=<current|all|one|off> — repeat the currently playing song, the current list, stop after one song, or turn repeat off
• --run — start Quod Libet if it isn't running
• --seek=<[+|-][HH:]MM:SS> — seek within the playing song
• --set-browser=BrowserName — set the current browser
• --show-window — show main window
• --shuffle=<off|on|t> — turn shuffle off, on, or toggle
• --shuffle-type=<random|weighted|off> — set the shuffle type to be random, to prefer higher rated songs, or turn shuffle off
• --start-hidden — don't show any windows on start 🙈
• --start-playing — begin playing immediately
• --status — print playing status
• --stop — stop playback ⏹️
• --stop-after=<0|1|t> — stop after the playing song
• --toggle-window — toggle main window visibility
• --unfilter — remove active browser filters
• --unqueue=<filename|query> — unqueue a file or query
• --version — display version and copyright
• --volume=<[+|-]0..100> — set the volume 🔊
• --volume-down — turn down the volume
• --volume-up — turn up the volume
• --with-pattern=<pattern> — set the output format of the --print-playing, --print-playlist, --print-query, and --print-queue commands. You may provide in a tag-pattern string like the kind described in the RENAMING FILES section below.

---

🦋 ALBUM COVERS 🦋

Album covers should go in the same directory as the songs they apply to, and their filenames need to have folder, front, or cover in them. Now — if you want to store <em>multiple</em> albums in the same directory but keep distinct cover images? The name of the right image file must contain the labelid tag value, e.g. COCX-32760 cover.jpg ✨

🧚 TIED TAGS 🧚

Many places in Quod Libet let you use "tied tags". A tied tag is two tag names joined together with a ~, like title~version or album~part. The way that tied tags give you <em>"nice"</em> displays even when one of the tags is missing?? Obsessed. For example, title~version results in Title - Version when a version tag is present, but just Title when one isn't. And you can tie any number of tags together 💅

🌈 SEARCH SYNTAX 🌈

All of Quod Libet's search boxes support advanced searches of these forms:

tag = value
tag = !value
tag = "value"
tag = /value/
tag = &(value1, value2)
tag = |(value1, value2)
!tag = value
|(tag1 = value1, tag2 = value2)
&(tag1 = value1, tag2 = value2)
#(numerictag < value)
#(numerictag = value)
#(numerictag > value)

The c postfix on strings or regular expressions makes the search case-sensitive. Numeric values may be given as integers, floating-point numbers, MM:SS format, or simple English, e.g. "3 days", "2 hours" ⏰

See https://quodlibet.readthedocs.io/en/latest/guide/searching.html.

All internal tags begin with a ~ character. The non-numeric internal tags are ~basename, ~dirname, ~filename, ~format, ~length, ~people, and ~rating. The numeric internal tags are ~#added, ~#bitrate, ~#disc, ~#lastplayed, ~#laststarted, ~#length, ~#mtime, ~#playcount, ~#skipcount, and ~#track.

See https://quodlibet.readthedocs.io/en/latest/guide/tags/internal_tags.html.

💜 RENAMING FILES 💜

Quod Libet lets you rename files based on their tags. Sometimes you wanna alter the filename depending on whether some tags are present or missing, not just their values. A common pattern might be:

<tracknumber>. <title~version>

You can use a '|' to only text when a tag is present:

<tracknumber|<tracknumber>. ><title~version>

And you can also specify literal text to use if the tag is missing by adding another '|':

<album|<album>|No Album> - <title>

See https://quodlibet.readthedocs.io/en/latest/guide/renaming_files.html.

🔥 AUDIO BACKENDS 🔥

Quod Libet uses GStreamer for audio playback. It tries to read your GConf GStreamer configuration, but if that fails it falls back to osssink. You can change the pipeline option in ~/.quodlibet/config to use a different sink, or pass options to the sink. For example, you might use esdsink or alsasink device=hw:1 🎧

See https://quodlibet.readthedocs.io/en/latest/guide/playback/backends.html.

📁 FILES 📁

• ~/.quodlibet/songs — a pickled Python dict of cached metadata. Deleting this file will remove all songs from your library. 😭 Do not do this casually bestie.
• ~/.quodlibet/config — Quod Libet's configuration file. This file is overwritten when Quod Libet exits.
• ~/.quodlibet/current — a "key=value" file containing information about the currently playing song.
• ~/.quodlibet/control — a FIFO connected to the most-recently-started instance of the program. --next, --previous, etc., use this to control the player.
• ~/.quodlibet/plugins/ — put plugins here.
• ~/.quodlibet/browsers/ — put custom library browsers here.

See https://quodlibet.readthedocs.io/en/latest/guide/interacting.html.

💀 BUGS 💀

See https://github.com/quodlibet/quodlibet/issues for a list of all currently open bugs and feature requests. (Not me reading the issue tracker for fun 🙈)

👑 AUTHORS 👑

Joe Wreschnig and Michael Urman are the primary authors of Quod Libet. Kings, honestly 👑

🌟 SEE ALSO 🌟

• https://quodlibet.readthedocs.io/en/latest/guide/
• https://quodlibet.readthedocs.io/en/latest/guide/faq.html
• regex(7)
• gst-launch(1)

---

and that's the whole page bestie, you ate that 💅✨

this was the QUODLIBET(1) manual page, version/date line and all — consider it signed off with love 🫶🎀💖