1QUODLIBET(1) QUODLIBET(1)
2
6 quodlibet - audio library manager and player
7
9 quodlibet [ --print-playing | control ]
10 exfalso [ directory ]
11
14 Quod Libet is a music management program. It provides several different
15 ways to view your audio library, as well as support for Internet radio
16 and audio feeds. It has extremely flexible metadata tag editing and
17 searching capabilities.
18 This manual page is only a short reference for Quod Libet. Complete
20 documentation is available at
21 https://quodlibet.readthedocs.io/en/latest/guide/index.html.
22
24 --add-location=<location>
25 Add a file or directory to the library
26 --debug
28 Print debugging information
29 --enqueue=<filename|query>
31 Enqueue a filename or query results
32 --enqueue-files=<filename[,filename..]>
34 Enqueue comma-separated files
35 --filter <tag=value>
37 Filter on a tag value
38 --focus
40 Focus the running player
41 --force-previous
43 Jump to previous song
44 --help Display brief usage information
46 --hide-window
48 Hide main window
49 --list-browsers
51 List available browsers
52 --next Jump to next song
54 --no-plugins
56 Start without plugins
57 --open-browser=BrowserName
59 Open a new browser
60 --pause
62 Pause playback
63 --play Start playback
65 --play-file=filename
67 Play a file
68 --play-pause
70 Toggle play/pause mode
71 --previous
73 Jump to previous song if near the beginning, otherwise restart
74 --print-playing
76 Print out information about the currently playing song. You may
77 provide in a string like the kind described in the RENAMING
78 FILES section below.
79 --print-playlist
81 Print the current playlist
82 --print-query=<query>
84 Print filenames of results of query
85 --print-query-text
87 Print the active text query
88 --print-queue
90 Print the contents of the queue
91 --query=search-string
93 Search your audio library
94 --queue=<on|off|t>
96 Show or hide the queue
97 --quit Exit Quod Libet
99 --random=tag
101 Filter on a random value
102 --rating=<[+|-]0.0..1.0>
104 Set rating of playing song
105 --rating-down
107 Decrease rating of playing song by one star
108 --rating-up
110 Increase rating of playing song by one star
111 --refresh
113 Refresh and rescan library
114 --repeat=<off|on|t>
116 Turn repeat off, on, or toggle
117 --repeat-type=<current|all|one|off>
119 Repeat the currently playing song, the current list, stop after
120 one song, or turn repeat off
121 --run Start Quod Libet if it isn't running
123 --seek=<[+|-][HH:]MM:SS>
125 Seek within the playing song
126 --set-browser=BrowserName
128 Set the current browser
129 --show-window
131 Show main window
132 --shuffle=<off|on|t>
134 Turn shuffle off, on, or toggle
135 --shuffle-type=<random|weighted|off>
137 Set the shuffle type to be random, to prefer higher rated songs,
138 or turn shuffle off
139 --start-hidden
141 Don't show any windows on start
142 --start-playing
144 Begin playing immediately
145 --status
147 Print playing status
148 --stop Stop playback
150 --stop-after=<0|1|t>
152 Stop after the playing song
153 --toggle-window
155 Toggle main window visibility
156 --unfilter
158 Remove active browser filters
159 --unqueue=<filename|query>
161 Unqueue a file or query
162 --version
164 Display version and copyright
165 --volume=<[+|-]0..100>
167 Set the volume
168 --volume-down
170 Turn down the volume
171 --volume-up
173 Turn up the volume
174
176 Album covers should be put in the same directory as the songs they
177 apply to, and have "folder", "front", or "cover" in their filenames. If
178 you want to store multiple albums in the same directory but keep dis‐
179 tinct cover images, the name of the appropriate image file must contain
180 the labelid tag value, e.g. COCX-32760 cover.jpg.
181
183 Many places in Quod Libet allow you to use "tied tags". Tied tags are
184 two tag names joined together with a "~" like "title~version" or
185 "album~part". Tied tags result in "nice" displays even when one of the
186 tags is missing; for example, "title~version" will result in Title -
187 Version when a version tag is present, but only Title when one isn't.
188 You can tie any number of tags together.
189
191 All of Quod Libet's search boxes support advanced searches of the fol‐
192 lowing forms:
193 tag = value
196 tag = !value
197 tag = "value"
198 tag = /value/
199 tag = &(value1, value2)
200 tag = |(value1, value2)
201 !tag = value
202 |(tag1 = value1, tag2 = value2)
203 &(tag1 = value1, tag2 = value2)
204 #(numerictag < value)
205 #(numerictag = value)
206 #(numerictag > value)
207 The 'c' postfix on strings or regular expressions makes the search
212 case-sensitive. Numeric values may be given as integers, floating-point
213 numbers, MM:SS format, or simple English, e.g. "3 days", "2 hours".
214 See https://quodlibet.readthedocs.io/en/latest/guide/searching.html.
216 All internal tags begin with a ~ character. Non-numeric internal tags
218 are ~base‐ name, ~dirname, ~filename, ~format, ~length, ~people, and
219 ~rating. Numeric internal tags are ~#added, ~#bitrate, ~#disc, ~#last‐
220 played, ~#laststarted, ~#length, ~#mtime, ~#playcount, ~#skipcount, and
221 ~#track.
222 See
224 https://quodlibet.readthedocs.io/en/latest/guide/tags/internal_tags.html.
225
227 Quod Libet allows you to rename files based on their tags. In some
228 cases you may wish to alter the filename depending on whether some tags
229 are present or missing, in addition to their values. A common pattern
230 might be
231 <tracknumber>. <title~version>
233 You can use a '|' to only text when a tag is present:
235 <tracknumber|<tracknumber>. ><title~version>
237 You can also specify literal text to use if the tag is missing by
239 adding another '|':
240 <album|<album>|No Album> - <title>
242 See
244 https://quodlibet.readthedocs.io/en/latest/guide/renaming_files.html.
245
247 Quod Libet uses GStreamer for audio playback. It tries to read your
248 GConf GStreamer configuration, but if that fails it falls back to
249 osssink. You can change the pipeline option in ~/.quodlibet/config to
250 use a different sink, or pass options to the sink. For example, you
251 might use esdsink or alsasink device=hw:1.
252 See
254 https://quodlibet.readthedocs.io/en/latest/guide/playback/backends.html.
255
257 ~/.quodlibet/songs
258 A pickled Python dict of cached metadata. Deleting this file
259 will remove all songs from your library.
260 ~/.quodlibet/config
262 Quod Libet's configuration file. This file is overwritten when
263 Quod Libet exits.
264 ~/.quodlibet/current
266 A "key=value" file containing information about the currently
267 playing song.
268 ~/.quodlibet/control
270 A FIFO connected to the most-recently-started instance of the
271 program. --next, --previous, etc., use this to control the
272 player.
273 ~/.quodlibet/plugins/
275 Put plugins here.
276 ~/.quodlibet/browsers/
278 Put custom library browsers here.
279 See https://quodlibet.readthedocs.io/en/latest/guide/interacting.html.
281
283 See https://github.com/quodlibet/quodlibet/issues for a list of all
284 currently open bugs and feature requests.
285
287 Joe Wreschnig and Michael Urman are the primary authors of Quod Libet.
288
290 https://quodlibet.readthedocs.io/en/latest/guide/,
291 https://quodlibet.readthedocs.io/en/latest/guide/faq.html,
292 regex(7), gst-launch(1)
293 QUODLIBET(1)