/usr/share/doc/draai/draai.html is in draai 20131212-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (c) 2013 Joost van Baal-Ilić <joostvb-draai@mdcc.cx> -->
<head>
<meta name="keywords" content="manual">
<style type="text/css">
/* START aephea.base.css */
body
{ text-align: justify;
margin-left: 0%;
margin-right: 0%;
}
a:link { text-decoration: none; }
a:active { text-decoration: none; }
a:visited { text-decoration: none; }
a:link { color: #1111aa; }
a:active { color: #1111aa; }
a:visited { color: #111166; }
a.local:link { color: #11aa11; }
a.local:active { color: #11aa11; }
a.local:visited { color: #116611; }
a.intern:link { color: #1111aa; }
a.intern:active { color: #1111aa; }
a.intern:visited { color: #111166; }
a.extern:link { color: #aa1111; }
a.extern:active { color: #aa1111; }
a.extern:visited { color: #661111; }
a.quiet:link { color: black; }
a.quiet:active { color: black; }
a.quiet:visited { color: black; }
div.verbatim
{ font-family: monospace;
margin-top: 1em;
margin-bottom: 1em;
font-size: 10pt;
margin-left: 2em;
white-space: pre;
}
div.indent
{ margin-left: 8%;
margin-right: 0%;
}
.right { text-align: right; }
.left { text-align: left; }
.nowrap { white-space: nowrap; }
.item_leader
{ position: relative;
margin-left: 8%;
}
.item_compact { position: absolute; vertical-align: baseline; }
.item_cascade { position: relative; }
.item_leftalign { text-align: left; }
.item_rightalign
{ width: 2em;
text-align: right;
}
.item_compact .item_rightalign
{ position: absolute;
width: 52em;
right: -2em;
text-align: right;
}
.item_text
{ position: relative;
margin-left: 3em;
}
.smallcaps { font-size: smaller; text-transform: uppercase }
/* END aephea.base.css */
body { font-family: "Garamond", "Gill Sans", "Verdana", sans-serif; }
body
{ text-align: justify;
margin-left: 8%;
margin-right: 8%;
}
</style>
<title>draai</title>
</head>
<body>
<p style="text-align:right">
12 дец 2013
<a class="local" href="draai.ps"><b>draai</b></a>
20131212
</p>
<a name="name"></a>
<h2>NAME</h2>
<p style="margin-bottom:0" class="asd_par">
draai — manage playlists and play audio files</p>
<a name="synopsis"></a>
<h2>SYNOPSIS</h2>
<p style="margin-bottom:0" class="asd_par">draai [option [option ...]] command [track [track ...] | tracknumber [tracknumber ...]]</p>
<a name="description"></a>
<h2>DESCRIPTION</h2>
Draai is a wrapper around mpc, making playing music from the commandline more
enjoyable. mpc is a client for MPD, the Music Player Daemon. Using draai, one
can play an audiofile (ogg, mp3, flac, whatever your MPD offers), play all
files in a predefined playlist, view details on current, past and future
playing songs, skip to the next song, etc.
<a name="getting started"></a>
<h2>GETTING STARTED</h2>
Run "draai init" to get started using draai the way the author likes it.
Other ways of using draai are possible, see below.
<a name="commands"></a>
<h2>COMMANDS</h2>
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_cascade"><div class=" item_leftalign nowrap " >draai</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Play music: the files given as args and playlists passed via --playlist.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >init</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Start a bunch of X terminals setting up some draai jobs: tail, logtail,
watch, syslog, ...
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >guestlist</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Reschedule listed tracknumbers as upcoming tracks. Last arguments should
be the positions of tracks to be put on the guestlist, not filenames.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >unguestlist</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Reschedule listed tracknumbers to end of playlist.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >insert</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Add file(s) (given either as args or on stdin) to playlist and schedule it as upcoming track.
You probably want to have 'draai insert' read from a pipe fed by 'draai search'.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >tail</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Print information about track when it starts playing, similar to
tail -f on a logfile.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >logtail</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Run tail(1) on system log file.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >list</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
List current playlist.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >peek</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Show status of current song, and show upcoming $peek FIXME tracks.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >syslog</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Send raw information from tail to syslog. You likely want to run "draai
syslog" in the background.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >skip</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Skip this track, start playing the next one now.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >osjittisstil</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Run this if unwanted silence pops up during a playing session (for now, it
runs draai --sloppy skip).
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >delete</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Delete track(s) from current playlist. Last arguments should be
_positions_ of tracks to be removed, not filename. If no position is
given, deletes upcoming track from playlist.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >fastforward</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Seek forward in current track.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " >quit</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
quit
</p>
</div>
</div>
<a name="options"></a>
<h2>OPTIONS</h2>
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><a name="opt--debug"></a><b>--debug</b> (<i>debug</i>), <b>-d</b></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Be very verbose.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><a name="opt--playlist"></a><b>--playlist</b> (<i>with playlistfile</i>), <b>-p</b></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Playlist file; option can be supplied more than once. To be used
with command "draai".
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><a name="opt--noshuffle"></a><b>--noshuffle</b> (<i>no shuffle</i>), {<b>-S</b>}</div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Do not shuffle tracks and leave random mode untouched (default is: do
shuffle and disable random mode). See also the script dr_unsort.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><a name="opt--raw"></a><b>--raw</b> (<i>raw</i>), <b>-r</b></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Print raw stuff, suitable for postprocessing (if combined with tail, peek
or list).
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><a name="opt--sloppy"></a><b>--sloppy</b> (<i>sloppy</i>), <b>-s</b></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Do not try hard to make everything sound smooth. If combined with skip:
risk a squeak on old hardware.
</p>
</div>
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><a name="opt--time"></a><b>--time</b> (<i>with timespec</i>), <b>-t</b></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
If combined with commands quit or draai: time at which to quit or start.
</p>
</div>
</div>
<a name="examples"></a>
<h2>EXAMPLES</h2>
Schedule all tracks containing the string 'delia gone' in title, artist, comment
or any other tag for playing, after current song has finished:
<tt>draai search 'delia gone' | draai insert</tt>.
<a name="environment"></a>
<h2>ENVIRONMENT</h2>
Run <tt>grep DR_ `which draai`</tt> to find out about environment variables
honored by draai. It honors: booleans:
DR_DEBUG
and
DR_SHUFFLE, DR_TIMESTAMP, DR_RAW and DR_SLOPPY
; strings:
DR_WATCH
; integers:
DR_CROSSFADE, DR_PEEK and DR_SEEK
as well as
DR_FADEOUT_STEP, DR_FADEOUT_REPEAT, and DR_FADEOUT_SLEEP
and
DR_VOLUME_STEP
; and some more strings:
DR_SYSLOG_FILE, DR_SYSLOG_FACILITY and DR_SYSLOG_LEVEL
. For now, see the draai code for what it all means.
<a name="files, configurarion"></a>
<h2>FILES, CONFIGURATION</h2>
All configuration variables (see ENVIRONMENT) can be set in <tt>~/.draai/rc</tt>.
This rc-file is sourced as a shell script. If you'd like to set the syslog
facility, set <i>syslog_facility</i> (overruled by DR_SYSLOG_FACILITY). If you'd
like to set the watch programma, set <i>watch</i> (overruled by DR_WATCH).
<a name="see also"></a>
<h2>SEE ALSO</h2>
Lots of alternatives for draai exist. One is "herrie", by Ed Schouten and
Martijn van den Dungen, see http://freshmeat.net/projects/herrie/.
<a name="copyright and license"></a>
<h2>COPYRIGHT AND LICENSE</h2>
Draai is (C) 2000-2013 Joost van Baal-Ilić <joostvb-draai@mdcc.cx>.
Draai is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License, as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version. This program is distributed WITHOUT ANY WARRANTY. You should have
received a copy of the GNU General Public License along with draai. If not,
see <a class="extern" href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>.
<a name="author"></a>
<h2>AUTHOR</h2>
Joost van Baal-Ilić <joostvb-draai@mdcc.cx>
</body>
</html>
|