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 --refresh
104 Refresh and rescan library
105 --repeat=<off|on|t>
107 Turn repeat off, on, or toggle
108 --repeat-type=<current|all|one|off>
110 Repeat the currently playing song, the current list, stop after
111 one song, or turn repeat off
112 --run Start Quod Libet if it isn't running
114 --seek=<[+|-][HH:]MM:SS>
116 Seek within the playing song
117 --set-browser=BrowserName
119 Set the current browser
120 --set-rating=<0.0..1.0>
122 Rate the playing song
123 --show-window
125 Show main window
126 --shuffle=<off|on|t>
128 Turn shuffle off, on, or toggle
129 --shuffle-type=<random|weighted|off>
131 Set the shuffle type to be random, to prefer higher rated songs,
132 or turn shuffle off
133 --start-hidden
135 Don't show any windows on start
136 --start-playing
138 Begin playing immediately
139 --status
141 Print playing status
142 --stop Stop playback
144 --stop-after=<0|1|t>
146 Stop after the playing song
147 --toggle-window
149 Toggle main window visibility
150 --unfilter
152 Remove active browser filters
153 --unqueue=<filename|query>
155 Unqueue a file or query
156 --version
158 Display version and copyright
159 --volume=<(+\|-\|)0..100>
161 Set the volume
162 --volume-down
164 Turn down the volume
165 --volume-up
167 Turn up the volume
168
170 Album covers should be put in the same directory as the songs they
171 apply to, and have "folder", "front", or "cover" in their filenames. If
172 you want to store multiple albums in the same directory but keep dis‐
173 tinct cover images, the name of the appropriate image file must contain
174 the labelid tag value, e.g. COCX-32760 cover.jpg.
175
177 Many places in Quod Libet allow you to use "tied tags". Tied tags are
178 two tag names joined together with a "~" like "title~version" or
179 "album~part". Tied tags result in "nice" displays even when one of the
180 tags is missing; for example, "title~version" will result in Title -
181 Version when a version tag is present, but only Title when one isn't.
182 You can tie any number of tags together.
183
185 All of Quod Libet's search boxes support advanced searches of the fol‐
186 lowing forms:
187 tag = value
190 tag = !value
191 tag = "value"
192 tag = /value/
193 tag = &(value1, value2)
194 tag = |(value1, value2)
195 !tag = value
196 |(tag1 = value1, tag2 = value2)
197 &(tag1 = value1, tag2 = value2)
198 #(numerictag < value)
199 #(numerictag = value)
200 #(numerictag > value)
201 The 'c' postfix on strings or regular expressions makes the search
206 case-sensitive. Numeric values may be given as integers, floating-point
207 numbers, MM:SS format, or simple English, e.g. "3 days", "2 hours".
208 See https://quodlibet.readthedocs.io/en/latest/guide/searching.html.
210 All internal tags begin with a ~ character. Non-numeric internal tags
212 are ~base‐ name, ~dirname, ~filename, ~format, ~length, ~people, and
213 ~rating. Numeric internal tags are ~#added, ~#bitrate, ~#disc, ~#last‐
214 played, ~#laststarted, ~#length, ~#mtime, ~#playcount, ~#skipcount, and
215 ~#track.
216 See
218 https://quodlibet.readthedocs.io/en/latest/guide/tags/internal_tags.html.
219
221 Quod Libet allows you to rename files based on their tags. In some
222 cases you may wish to alter the filename depending on whether some tags
223 are present or missing, in addition to their values. A common pattern
224 might be
225 <tracknumber>. <title~version>
227 You can use a '|' to only text when a tag is present:
229 <tracknumber|<tracknumber>. ><title~version>
231 You can also specify literal text to use if the tag is missing by
233 adding another '|':
234 <album|<album>|No Album> - <title>
236 See
238 https://quodlibet.readthedocs.io/en/latest/guide/renaming_files.html.
239
241 Quod Libet uses GStreamer for audio playback. It tries to read your
242 GConf GStreamer configuration, but if that fails it falls back to
243 osssink. You can change the pipeline option in ~/.quodlibet/config to
244 use a different sink, or pass options to the sink. For example, you
245 might use esdsink or alsasink device=hw:1.
246 See
248 https://quodlibet.readthedocs.io/en/latest/guide/playback/backends.html.
249
251 ~/.quodlibet/songs
252 A pickled Python dict of cached metadata. Deleting this file
253 will remove all songs from your library.
254 ~/.quodlibet/config
256 Quod Libet's configuration file. This file is overwritten when
257 Quod Libet exits.
258 ~/.quodlibet/current
260 A "key=value" file containing information about the currently
261 playing song.
262 ~/.quodlibet/control
264 A FIFO connected to the most-recently-started instance of the
265 program. --next, --previous, etc., use this to control the
266 player.
267 ~/.quodlibet/plugins/
269 Put plugins here.
270 ~/.quodlibet/browsers/
272 Put custom library browsers here.
273 See https://quodlibet.readthedocs.io/en/latest/guide/interacting.html.
275
277 See https://github.com/quodlibet/quodlibet/issues for a list of all
278 currently open bugs and feature requests.
279
281 Joe Wreschnig and Michael Urman are the primary authors of Quod Libet.
282
284 https://quodlibet.readthedocs.io/en/latest/guide/,
285 https://quodlibet.readthedocs.io/en/latest/guide/faq.html,
286 regex(7), gst-launch(1)
287 QUODLIBET(1)