1QUODLIBET(1)                                                      QUODLIBET(1)
2
3
4

NAME

6       quodlibet - audio library manager and player
7

SYNOPSIS

9       quodlibet [ --print-playing | control ]
10       exfalso [ directory ]
11
12

DESCRIPTION

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
19       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

OPTIONS

24       --add-location=<location>
25              Add a file or directory to the library
26
27       --debug
28              Print debugging information
29
30       --enqueue=<filename|query>
31              Enqueue a filename or query results
32
33       --enqueue-files=<filename[,filename..]>
34              Enqueue comma-separated files
35
36       --filter <tag=value>
37              Filter on a tag value
38
39       --focus
40              Focus the running player
41
42       --force-previous
43              Jump to previous song
44
45       --help Display brief usage information
46
47       --hide-window
48              Hide main window
49
50       --list-browsers
51              List available browsers
52
53       --next Jump to next song
54
55       --no-plugins
56              Start without plugins
57
58       --open-browser=BrowserName
59              Open a new browser
60
61       --pause
62              Pause playback
63
64       --play Start playback
65
66       --play-file=filename
67              Play a file
68
69       --play-pause
70              Toggle play/pause mode
71
72       --previous
73              Jump to previous song if near the beginning, otherwise restart
74
75       --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
80       --print-playlist
81              Print the current playlist
82
83       --print-query=<query>
84              Print filenames of results of query
85
86       --print-query-text
87              Print the active text query
88
89       --print-queue
90              Print the contents of the queue
91
92       --query=search-string
93              Search your audio library
94
95       --queue=<on|off|t>
96              Show or hide the queue
97
98       --quit Exit Quod Libet
99
100       --random=tag
101              Filter on a random value
102
103       --rating=<[+|-]0.0..1.0>
104              Set rating of playing song
105
106       --rating-down
107              Decrease rating of playing song by one star
108
109       --rating-up
110              Increase rating of playing song by one star
111
112       --refresh
113              Refresh and rescan library
114
115       --repeat=<off|on|t>
116              Turn repeat off, on, or toggle
117
118       --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
122       --run  Start Quod Libet if it isn't running
123
124       --seek=<[+|-][HH:]MM:SS>
125              Seek within the playing song
126
127       --set-browser=BrowserName
128              Set the current browser
129
130       --show-window
131              Show main window
132
133       --shuffle=<off|on|t>
134              Turn shuffle off, on, or toggle
135
136       --shuffle-type=<random|weighted|off>
137              Set the shuffle type to be random, to prefer higher rated songs,
138              or turn shuffle off
139
140       --start-hidden
141              Don't show any windows on start
142
143       --start-playing
144              Begin playing immediately
145
146       --status
147              Print playing status
148
149       --stop Stop playback
150
151       --stop-after=<0|1|t>
152              Stop after the playing song
153
154       --toggle-window
155              Toggle main window visibility
156
157       --unfilter
158              Remove active browser filters
159
160       --unqueue=<filename|query>
161              Unqueue a file or query
162
163       --version
164              Display version and copyright
165
166       --volume=<[+|-]0..100>
167              Set the volume
168
169       --volume-down
170              Turn down the volume
171
172       --volume-up
173              Turn up the volume
174

ALBUM COVERS

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

TIED TAGS

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

SEARCH SYNTAX

191       All of Quod  Libet's search boxes support advanced searches of the fol‐
192       lowing forms:
193
194
195       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
208
209
210
211       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
215       See https://quodlibet.readthedocs.io/en/latest/guide/searching.html.
216
217       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
223       See
224       https://quodlibet.readthedocs.io/en/latest/guide/tags/internal_tags.html.
225

RENAMING FILES

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
232       <tracknumber>. <title~version>
233
234       You can use a '|' to only text when a tag is present:
235
236       <tracknumber|<tracknumber>. ><title~version>
237
238       You  can  also  specify  literal  text  to use if the tag is missing by
239       adding another '|':
240
241       <album|<album>|No Album> - <title>
242
243       See
244       https://quodlibet.readthedocs.io/en/latest/guide/renaming_files.html.
245

AUDIO BACKENDS

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
253       See
254       https://quodlibet.readthedocs.io/en/latest/guide/playback/backends.html.
255

FILES

257       ~/.quodlibet/songs
258              A  pickled  Python  dict  of cached metadata. Deleting this file
259              will remove all songs from your library.
260
261       ~/.quodlibet/config
262              Quod Libet's configuration file. This file is  overwritten  when
263              Quod Libet exits.
264
265       ~/.quodlibet/current
266              A  "key=value"  file  containing information about the currently
267              playing song.
268
269       ~/.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
274       ~/.quodlibet/plugins/
275              Put plugins here.
276
277       ~/.quodlibet/browsers/
278              Put custom library browsers here.
279
280       See https://quodlibet.readthedocs.io/en/latest/guide/interacting.html.
281

BUGS

283       See https://github.com/quodlibet/quodlibet/issues for  a  list  of  all
284       currently open bugs and feature requests.
285

AUTHORS

287       Joe Wreschnig and Michael Urman are the primary authors of Quod Libet.
288

SEE ALSO

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
294
295
296
297
298                                                                  QUODLIBET(1)
Impressum