1quodlibet(1) General Commands Manual quodlibet(1)
2
6 quodlibet - audio library manager and player
7
9 quodlibet [ --print-playing | control ]
10 exfalso [ directory ]
11
13 Quod Libet is a music management program. It provides several different
14 ways to view your audio library, as well as support for Internet radio
15 and audio feeds. It has extremely flexible metadata tag editing and
16 searching capabilities.
17 This manual page is only a short reference for Quod Libet. Complete
19 documentation is available at http://www.sacredchao.net/quodli‐
20 bet/wiki/Guide.
21
23 --enqueue filename|query
24 Enqueue a filename or query results.
25 --filter tag=value
27 Filter on a tag value
28 --focus
30 Focus the running player
31 --hide-window
33 Hide main window
34 --next
36 Jump to next song
37 --open-browser=BrowserName
39 Open a new browser
40 --order=inorder|shuffle|weighted|onesong|toggle
42 Set or toggle the playback order
43 --pause
45 Pause playback
46 --play
48 Start playback
49 --play-file=filename
51 Play a file
52 --play-pause
54 Toggle play/pause mode
55 --previous
57 Jump to previous song
58 --print-playlist
60 Print the current playlist
61 --print-queue
63 Print the contents of the queue
64 --print-playing
66 Print out information about the currently playing song. You may
67 provide in a string like the kind described in the RENAMING FILES
68 section below.
69 --query=search-string
71 Search your audio library
72 --quit
74 Exit Quod Libet
75 --random=tag
77 Filter on a random value
78 --repeat=off|on|t
80 Turn repeat off, on, or toggle
81 --seek=[+|-][HH:]MM:SS
83 Seek within the playing song
84 --set-browser=BrowserName
86 Set the current browser
87 --set-rating=0.0..1.0
89 Rate the playing song
90 --show-window
92 Hide main window
93 --start-playing
95 Begin playing immediately
96 --status
98 Print playing status
99 --toggle-window
101 Toggle main window visibility
102 --unfilter
104 Remove active browser filters
105 --unqueue=filename|query
107 Unqueue a file or query
108 --volume=+|-|0..100
110 Set the volume
111
113 Album covers should be put in the same directory as the songs they
114 apply to, and have "folder", "front", or "cover" in their filenames.
115 If you want to store multiple albums in the same directory but keep
116 distinct cover images, the name of the appropriate image file must con‐
117 tain the labelid tag value, e.g. COCX-32760 cover.jpg.
118
120 Many places in Quod Libet allow you to use "tied tags". Tied tags are
121 two tag names joined together with a "~" like "title~version" or
122 "album~part". Tied tags result in "nice" displays even when one of the
123 tags is missing; for example, "title~version" will result in
124 Title - Version when a version tag is present, but only Title when one
125 isn't. You can tie any number of tags together.
126
128 All of Quod Libet's search boxes support advanced searches of the fol‐
129 lowing forms:
130 tag = value
131 tag = !value
132 tag = "value"
133 tag = /value/
134 tag = &(value1, value2)
135 tag = |(value1, value2)
136 !tag = value
137 |(tag1 = value1, tag2 = value2)
138 &(tag1 = value1, tag2 = value2)
139 #(numerictag < value)
140 #(numerictag = value)
141 #(numerictag > value)
142 The 'c' postfix on strings or regular expressions makes the search
143 case-sensitive. Numeric values may be given as integers, floating-point
144 numbers, MM:SS format, or simple English, e.g. "3 days", "2 hours".
145 See http://www.sacredchao.net/quodlibet/wiki/Guide/Searching.
147 All internal tags begin with a ~ character. Non-numeric internal tags
149 are ~basename, ~dirname, ~filename, ~format, ~length, ~people, and
150 ~rating. Numeric internal tags are ~#added, ~#bitrate, ~#disc, ~#last‐
151 played, ~#laststarted, ~#length, ~#mtime, ~#playcount, ~#skipcount, and
152 ~#track.
153 See http://www.sacredchao.net/quodlibet/wiki/Guide/InternalTags.
155
157 Quod Libet allows you to rename files based on their tags. In some
158 cases you may wish to alter the filename depending on whether some tags
159 are present or missing, in addition to their values. A common pattern
160 might be
161 <tracknumber>. <title~version>
162 You can use a '|' to only text when a tag is present:
163 <tracknumber|<tracknumber>. ><title~version>
164 You can also specify literal text to use if the tag is missing by
165 adding another '|':
166 <album|<album>|No Album> - <title>
167 See http://www.sacredchao.net/quodlibet/wiki/Guide/Renaming.
168
170 Quod Libet uses GStreamer for audio playback. It tries to read your
171 GConf GStreamer configuration, but if that fails it falls back to
172 osssink. You can change the pipeline option in ~/.quodlibet/config to
173 use a different sink, or pass options to the sink. For example, you
174 might use esdsink or alsasink device=hw:1.
175 See http://www.sacredchao.net/quodlibet/wiki/Guide/AudioBackends.
177
179 ~/.quodlibet/songs
180 A pickled Python dict of cached metadata. Deleting this file will
181 remove all songs from your library.
182 ~/.quodlibet/config
184 Quod Libet's configuration file. This file is overwritten when Quod
185 Libet exits.
186 ~/.quodlibet/current
188 A "key=value" file containing information about the currently play‐
189 ing song.
190 ~/.quodlibet/control
192 A FIFO connected to the most-recently-started instance of the pro‐
193 gram. --next, --previous, etc., use this to control the player.
194 ~/.quodlibet/plugins/
196 Put plugins (from http://www.sacredchao.net/quodlibet/wiki/Plugins)
197 here.
198 ~/.quodlibet/browsers/
200 Put custom library browsers here.
201 See http://www.sacredchao.net/quodlibet/wiki/Guide/Extending.
203
205 See https://www.sacredchao.net/quodlibet/report/1 for a list of all
206 currently open bugs and feature requests.
207
209 Joe Wreschnig and Michael Urman are the primary authors of Quod Libet.
210
212 http://www.sacredchao.net/quodlibet/wiki/Guide,
213 http://www.sacredchao.net/quodlibet/wiki/FAQ,
214 regex(7), gst-launch(1)
215 November 26th, 2005 quodlibet(1)