1
.\" Copyright (c) 2008 Joost van Baal <joostvb-draai@mdcc\&.cx>
2
.TH "draai" 1 "28 nov 2008" "draai 20090615" "USER COMMANDS "
5
.\" Zoem Indent/Itemize macro I.
12
\h'|\\n(xau'\\$2\h'\\n(xbu'\\
16
.\" Zoem Indent/Itemize macro II.
23
\h'|\\n(xau'\\$3\h'\\n(xbu'\\
31
draai \- manage playlists and play audio files
34
draai [option [option \&.\&.\&.]] command [track [track \&.\&.\&.] | tracknumber [tracknumber \&.\&.\&.]]
36
Draai is a wrapper around mpc, making playing music from the commandline more
37
enjoyable\&. mpc is a client for MPD, the Music Player Daemon\&. Using draai, one
38
can play an audiofile (ogg, mp3, flac, whatever your MPD offers), play all
39
files in a predefined playlist, view details on current, past and future
40
playing songs, skip to the next song, etc\&.
42
Run "draai init" to get started using draai the way the author likes it\&.
43
Others ways of using draai are possible, see below\&.
55
Start a bunch of X terminals setting up some draai jobs: tail, logtail, peek,
62
Reschedule listed tracknumbers as upcoming tracks\&. Last arguments should be
63
the positions of tracks to be put on the guestlist, not filenames\&.
69
Reschedule listed tracknumbers to end of playlist\&.
75
Print information about track when it starts playing, similar to
76
tail -f on a logfile\&.
82
Run tail(1) on system log file\&.
88
List current playlist\&.
94
Show status of current song, and show upcoming $peek FIXME tracks\&.
100
Send raw information from tail to syslog\&. You likely want to run "draai syslog"
107
Skip this track, start playing the next one now\&.
110
.ZI 3m "osjittisstil"
113
Run this if unwanted silence pops up during a playing session (for now, it runs
114
draai --sloppy skip)\&.
120
Delete track(s) from current playlist\&. Last arguments should be _positions_ of
121
tracks to be removed, not filename\&. If no position is given, deletes upcoming
122
track from playlist\&.
128
Seek forward in current track\&.
138
.ZI 3m "\fB--debug\fP (\fIdebug\fP), \fB-d\fP"
144
.ZI 3m "\fB--playlist\fP (\fIwith playlistfile\fP), \fB-p\fP"
147
Playlist file; option can be supplied more than once\&. To be used
148
with command "draai"\&.
151
.ZI 3m "\fB--noshuffle\fP (\fIno shuffle\fP), {\fB-S\fP}"
154
Don\&'t shuffle tracks and leave random mode untouched (default is: do shuffle
155
and disable random mode)\&. See also the script dr_unsort\&.
158
.ZI 3m "\fB--raw\fP (\fIraw\fP), \fB-r\fP"
161
Print raw stuff, suitable for postprocessing (if combined with tail, peek or
165
.ZI 3m "\fB--sloppy\fP (\fIsloppy\fP), \fB-s\fP"
168
Don\&'t try hard to make everything sound smooth\&. If combined with skip: risk a
169
squeak on old hardware\&.
172
.ZI 3m "\fB--time\fP (\fIwith timespec\fP), \fB-t\fP"
175
If combined with commands quit or draai: time at which to quit or start\&.
178
draai honors: booleans:
197
; and some more strings:
201
\&. For now, see the draai code for what it all means\&.
202
.SH FILES, CONFIGURATION
203
All configuration variables (see ENVIRONMENT) can be set in \fC~/\&.draai/rc\fP\&.
204
This rc-file is sourced as a shell script\&. If you\&'d like to set the syslog
205
facility, set \fIsyslog_facility\fP (overruled by DR_SYSLOG_FACILITY)\&. If you\&'d
206
like to set the watch programma, set \fIwatch\fP (overruled by DR_WATCH)\&.
208
Lots of alternatives for draai exist\&. One is "herrie", by Ed Schouten and
209
Martijn van den Dungen, see http://freshmeat\&.net/projects/herrie/\&.
210
.SH COPYRIGHT AND LICENSE
211
Draai is (C) 2000-2008 Joost van Baal <joostvb-draai@mdcc\&.cx>\&.
212
Draai is free software; you can redistribute it and/or modify it under the
213
terms of the GNU General Public License, as published by the Free Software
214
Foundation, either version 3 of the License, or (at your option) any later
215
version\&. This program is distributed WITHOUT ANY WARRANTY\&. You should have
216
received a copy of the GNU General Public License along with draai\&. If not,
217
see http://www\&.gnu\&.org/licenses/\&.
219
Joost van Baal <joostvb-draai@mdcc\&.cx>