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 --with-pattern=<pattern>
176 Set the output format of the --print-playing, --print-playlist,
177 --print-query, and --print-queue commands. You may provide in a
178 tag-pattern string like the kind described in the RENAMING FILES
179 section below.
180
182 Album covers should be put in the same directory as the songs they ap‐
183 ply to, and have "folder", "front", or "cover" in their filenames. If
184 you want to store multiple albums in the same directory but keep dis‐
185 tinct cover images, the name of the appropriate image file must contain
186 the labelid tag value, e.g. COCX-32760 cover.jpg.
187
189 Many places in Quod Libet allow you to use "tied tags". Tied tags are
190 two tag names joined together with a "~" like "title~version" or "al‐
191 bum~part". Tied tags result in "nice" displays even when one of the
192 tags is missing; for example, "title~version" will result in Title -
193 Version when a version tag is present, but only Title when one isn't.
194 You can tie any number of tags together.
195
197 All of Quod Libet's search boxes support advanced searches of the fol‐
198 lowing forms:
199 tag = value
202 tag = !value
203 tag = "value"
204 tag = /value/
205 tag = &(value1, value2)
206 tag = |(value1, value2)
207 !tag = value
208 |(tag1 = value1, tag2 = value2)
209 &(tag1 = value1, tag2 = value2)
210 #(numerictag < value)
211 #(numerictag = value)
212 #(numerictag > value)
213 The 'c' postfix on strings or regular expressions makes the search
218 case-sensitive. Numeric values may be given as integers, floating-point
219 numbers, MM:SS format, or simple English, e.g. "3 days", "2 hours".
220 See https://quodlibet.readthedocs.io/en/latest/guide/searching.html.
222 All internal tags begin with a ~ character. Non-numeric internal tags
224 are ~base‐ name, ~dirname, ~filename, ~format, ~length, ~people, and
225 ~rating. Numeric internal tags are ~#added, ~#bitrate, ~#disc, ~#last‐
226 played, ~#laststarted, ~#length, ~#mtime, ~#playcount, ~#skipcount, and
227 ~#track.
228 See
230 https://quodlibet.readthedocs.io/en/latest/guide/tags/internal_tags.html.
231
233 Quod Libet allows you to rename files based on their tags. In some
234 cases you may wish to alter the filename depending on whether some tags
235 are present or missing, in addition to their values. A common pattern
236 might be
237 <tracknumber>. <title~version>
239 You can use a '|' to only text when a tag is present:
241 <tracknumber|<tracknumber>. ><title~version>
243 You can also specify literal text to use if the tag is missing by
245 adding another '|':
246 <album|<album>|No Album> - <title>
248 See
250 https://quodlibet.readthedocs.io/en/latest/guide/renaming_files.html.
251
253 Quod Libet uses GStreamer for audio playback. It tries to read your
254 GConf GStreamer configuration, but if that fails it falls back to os‐
255 ssink. You can change the pipeline option in ~/.quodlibet/config to use
256 a different sink, or pass options to the sink. For example, you might
257 use esdsink or alsasink device=hw:1.
258 See
260 https://quodlibet.readthedocs.io/en/latest/guide/playback/backends.html.
261
263 ~/.quodlibet/songs
264 A pickled Python dict of cached metadata. Deleting this file
265 will remove all songs from your library.
266 ~/.quodlibet/config
268 Quod Libet's configuration file. This file is overwritten when
269 Quod Libet exits.
270 ~/.quodlibet/current
272 A "key=value" file containing information about the currently
273 playing song.
274 ~/.quodlibet/control
276 A FIFO connected to the most-recently-started instance of the
277 program. --next, --previous, etc., use this to control the
278 player.
279 ~/.quodlibet/plugins/
281 Put plugins here.
282 ~/.quodlibet/browsers/
284 Put custom library browsers here.
285 See https://quodlibet.readthedocs.io/en/latest/guide/interacting.html.
287
289 See https://github.com/quodlibet/quodlibet/issues for a list of all
290 currently open bugs and feature requests.
291
293 Joe Wreschnig and Michael Urman are the primary authors of Quod Libet.
294
296 https://quodlibet.readthedocs.io/en/latest/guide/,
297 https://quodlibet.readthedocs.io/en/latest/guide/faq.html,
298 regex(7), gst-launch(1)
299 QUODLIBET(1)