1
.TH quodlibet 1 "November 26th, 2005"
3
quodlibet \- audio library manager and player
5
\fBquodlibet\fR [ \fB\-\-print\-playing\fR | \fIcontrol\fR ]
7
\fBexfalso\fR [ \fIdirectory\fR ]
9
Quod Libet is a music management program. It provides several different ways
10
to view your audio library, as well as support for Internet radio and
11
audio feeds. It has extremely flexible metadata tag editing and searching
14
This manual page is only a short reference for Quod Libet.
15
Complete documentation is available at
16
http://www.sacredchao.net/quodlibet/wiki/Guide.
17
.SH QUOD\ LIBET\ OPTIONS
18
.IP \-\-enqueue\ \fIfilename\fR|\fIquery\fR 4
19
Enqueue a filename or query results.
20
.IP \-\-filter\ \fItag\fR=\fIvalue\fR 4
23
Focus the running player
24
.IP \-\-hide\-window 4
28
.IP \-\-open\-browser=\fIBrowserName\fR 4
30
.IP \-\-order=\fBinorder\fR|\fBshuffle\fR|\fBweighted\fR|\fBonesong\fR|\fBtoggle\fR 4
31
Set or toggle the playback order
36
.IP \-\-play\-file=\fIfilename\fR 4
39
Toggle play/pause mode
42
.IP \-\-print-playlist 4
43
Print the current playlist
45
Print the contents of the queue
46
.IP \-\-print\-playing 4
47
Print out information about the currently playing song. You may provide
48
in a string like the kind described in the \fBRENAMING FILES\fR section
50
.IP \-\-query=\fIsearch\-string\fR 4
51
Search your audio library
54
.IP \-\-random=\fItag\fR 4
55
Filter on a random value
56
.IP \-\-repeat=\fBoff\fR|\fBon\fR|\fBt\fR 4
57
Turn repeat off, on, or toggle
58
.IP \-\-seek=\fI[+|\-][HH:]MM:SS\fR 4
59
Seek within the playing song
60
.IP \-\-set\-browser=\fIBrowserName\fR 4
61
Set the current browser
62
.IP \-\-set\-rating=\fB0.0\fR..\fB1.0\fR 4
64
.IP \-\-show\-window 4
66
.IP \-\-start\-playing 4
67
Begin playing immediately
70
.IP \-\-toggle\-window 4
71
Toggle main window visibility
73
Remove active browser filters
74
.IP \-\-unqueue=\fIfilename\fR|\fIquery\fR 4
75
Unqueue a file or query
76
.IP \-\-volume=\fB+\fR|\fB\-\fR|\fB0\fR..\fB100\fR 4
79
Album covers should be put in the same directory as the songs they
80
apply to, and have "folder", "front", or "cover" in their filenames.
81
If you want to store multiple albums in the same directory but keep
82
distinct cover images, the name of the appropriate image file must
83
contain the \fBlabelid\fI tag value, e.g. \fICOCX\-32760 cover.jpg\fR.
85
Many places in Quod Libet allow you to use "tied tags". Tied tags are two tag
86
names joined together with a "~" like "title~version" or "album~part".
87
Tied tags result in "nice" displays even when one of the tags is missing;
88
for example, "title~version" will result in \fITitle\ \-\ Version\fR when
89
a version tag is present, but only \fITitle\fR when one isn't. You can
90
tie any number of tags together.
92
All of Quod Libet's search boxes support advanced searches of the
103
tag = &(value1, value2)
105
tag = |(value1, value2)
109
|(tag1 = value1, tag2 = value2)
111
&(tag1 = value1, tag2 = value2)
113
#(numerictag < value)
115
#(numerictag = value)
117
#(numerictag > value)
119
The '\fBc\fR' postfix on strings or regular expressions makes the search
120
case-sensitive. Numeric values may be given as integers, floating-point
121
numbers, MM:SS format, or simple English, e.g. "3 days", "2 hours".
123
See http://www.sacredchao.net/quodlibet/wiki/Guide/Searching.
125
All internal tags begin with a ~ character. Non-numeric internal tags
126
are ~basename, ~dirname, ~filename, ~format, ~length, ~people, and ~rating.
127
Numeric internal tags are ~#added, ~#bitrate, ~#disc, ~#lastplayed,
128
~#laststarted, ~#length, ~#mtime, ~#playcount, ~#skipcount, and ~#track.
130
See http://www.sacredchao.net/quodlibet/wiki/Guide/InternalTags.
132
Quod Libet allows you to rename files based on their tags. In some
133
cases you may wish to alter the filename depending on whether some
134
tags are present or missing, in addition to their values. A common
137
<tracknumber>. <title~version>
139
You can use a '|' to only text when a tag is present:
141
<tracknumber|<tracknumber>. ><title~version>
143
You can also specify literal text to use if the tag is missing by adding
146
<album|<album>|No Album> \- <title>
148
See http://www.sacredchao.net/quodlibet/wiki/Guide/Renaming.
150
Quod Libet uses GStreamer for audio playback. It tries to read your GConf
151
GStreamer configuration, but if that fails it falls back to osssink. You
152
can change the \fBpipeline\fR option in \fI~/.quodlibet/config\fR to use
153
a different sink, or pass options to the sink. For example, you might use
154
\fBesdsink\fR or \fBalsasink device=hw:1\fR.
156
See http://www.sacredchao.net/quodlibet/wiki/Guide/AudioBackends.
158
.IP \fI~/.quodlibet/songs\fR 4
159
A pickled Python dict of cached metadata. Deleting this file will remove
160
all songs from your library.
161
.IP \fI~/.quodlibet/config\fR 4
162
Quod Libet's configuration file. This file is overwritten when Quod Libet
164
.IP \fI~/.quodlibet/current\fR 4
165
A "key=value" file containing information about the currently playing song.
166
.IP \fI~/.quodlibet/control\fR 4
167
A FIFO connected to the most-recently-started instance of the program.
168
\-\-next, \-\-previous, etc., use this to control the player.
169
.IP \fI~/.quodlibet/plugins/\fR 4
170
Put plugins (from http://www.sacredchao.net/quodlibet/wiki/Plugins) here.
171
.IP \fI~/.quodlibet/browsers/\fR 4
172
Put custom library browsers here.
174
See http://www.sacredchao.net/quodlibet/wiki/Guide/Extending.
176
See https://www.sacredchao.net/quodlibet/report/1 for a list of
177
all currently open bugs and feature requests.
179
Joe Wreschnig and Michael Urman are the primary authors of Quod Libet.
181
http://www.sacredchao.net/quodlibet/wiki/Guide,
183
http://www.sacredchao.net/quodlibet/wiki/FAQ,
added
removed
man/quodlibet.1
