# status

don't know, haven't tried using it in a while.  probably needs quite
some work.  don't expect it to work.


# intro

playfs - maintain play list and play audio files

typically mounted under /mnt/play.

/ctl
        write commands to, such as "play", "stop", "pause", "next",
        "previous", "rewind" "repeat", "norepeat", "random",
        "norandom"
/events
        read events from, such as "done", "playing $path", "error
        $path $error" "stopped" "started"
/list
        the playlist.  read the entire list from it (each line
        contains a path).  open with truncate to clear the list,
        write to it to add to the list.  read back in the order the
        elements were written
/status
        current status of player: started, stopped, paused, or
        playing $path
/offset
        offset (in line numbers) in playlist, starts at 0.  index
        to orderlist.  readable and writable.
/orderlist
        playlist in order of being played.  when playing in "norandom"
        order, this will be the same as the contents of /list.  when
        playing random, this is the shuffled list.  note that only
        /list is writable, /orderlist is read-only.


# install

make sure you have $ROOT set, now "mk" to compile and
"mk install" to install the files.

when building from within inferno, insert SYSHOST=Inferno and ROOT=
in the mk invocations to override the values in the mkconfig.


# licence & author

this code is in the public domain, written by mechiel lukkien,
reachable at mechiel@ueber.net or mechiel@xs4all.nl.


# todo

- think about an acme program, mostly commands that say "play" "stop" etc.
- manual pages, eventually

# testing

- /offset writable
- add mp3dec or play to this hg repo
- read audio data and write to /dev/audio ourselves, allows implementing pause 
- somehow allow user to read currently position in playlist file? (file "offset")
- allow reading of the playlist in played order (not order of adding) (orderlist)
- give better status info in playview
- status file showing current status?
- better status messages, say what is playing.  add state to events fid when opened?
	* played path
	* error path err (quoted)
	* done (nothing more to play)
	* playing path (started playing path)
	* stopped (got a stop request or this is read when opening events file)
	* started (got a play request)
	* paused