draai(1)							  USER COMMANDS 							  draai(1)

  NAME
      draai - manage playlists and play audio files

  SYNOPSIS
      draai [option [option ...]] command [track [track ...] | tracknumber [tracknumber ...]]

  DESCRIPTION
      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.

  GETTING STARTED
      Run "draai init" to get started using draai the way the author likes it.	Other ways of using draai are possible, see below.

  COMMANDS
      draai
	Play music.
      init
	Start a bunch of X terminals setting up some draai jobs: tail, logtail, peek, syslog, ...
      guestlist
	Reschedule  listed tracknumbers as upcoming tracks. Last arguments should be the positions of tracks to be put on the guestlist, not file-
	names.
      unguestlist
	Reschedule listed tracknumbers to end of playlist.
      insert
	Add file to playlist and schedule it as upcoming track.
      tail
	Print information about track when it starts playing, similar to tail -f on a logfile.
      logtail
	Run tail(1) on system log file.
      list
	List current playlist.
      peek
	Show status of current song, and show upcoming $peek FIXME tracks.
      syslog
	Send raw information from tail to syslog. You likely want to run "draai syslog" in the background.
      skip
	Skip this track, start playing the next one now.
      osjittisstil
	Run this if unwanted silence pops up during a playing session (for now, it runs draai --sloppy skip).
      delete
	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.
      fastforward
	Seek forward in current track.
      quit
	quit

  OPTIONS
      --debug (debug), -d
	Be very verbose.
      --playlist (with playlistfile), -p
	Playlist file; option can be supplied more than once. To be used with command "draai".
      --noshuffle (no shuffle), {-S}
	Don't shuffle tracks and leave random mode untouched (default is: do shuffle and disable random mode). See also the script dr_unsort.
      --raw (raw), -r
	Print raw stuff, suitable for postprocessing (if combined with tail, peek or list).
      --sloppy (sloppy), -s
	Don't try hard to make everything sound smooth. If combined with skip: risk a squeak on old hardware.
      --time (with timespec), -t
	If combined with commands quit or draai: time at which to quit or start.

  ENVIRONMENT
      Run  grep DR_ `which draai` to find out about environment variables honored by draai. It honors: booleans: DR_DEBUG and DR_SHUFFLE, DR_TIME-
      STAMP, 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.

  FILES, CONFIGURATION
      All configuration variables (see ENVIRONMENT) can be set in ~/.draai/rc.	This rc-file is sourced as a shell script. If you'd  like  to  set
      the  syslog  facility, set syslog_facility (overruled by DR_SYSLOG_FACILITY). If you'd like to set the watch programma, set watch (overruled
      by DR_WATCH).

  SEE ALSO
      Lots of alternatives for draai exist. One is "herrie", by Ed Schouten and Martijn van den Dungen, see http://freshmeat.net/projects/herrie/.

  COPYRIGHT AND LICENSE
      Draai is (C) 2000-2008 Joost van Baal <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 http://www.gnu.org/licenses/.

  AUTHOR
      Joost van Baal <joostvb-draai@mdcc.cx>

  draai 20110603						     03 juin 2011							    draai(1)