z! supports several commands that can be accessed via named-pipe, which will
let you control z! from the commandline, your programs or even over netbios shares!

a simple example of pausing the playback of z! from the commandline while its
allready playing a song would be:

	echo *pause > \pipe\zmp3

(note, all of z!'s pipe commands are prefixed with '*')

here is the list of commands:

        command         description
        -------         -----------
        pause            - pause playback
        mute             - mute playback
        next             - jumps to the next track
        previous         - jumps to the previous track
        stop             - stops playback and returns to the file-selector
        seek [x]         - seek to position in track (in seconds, -# to seek backwards)
        vol+             - raises the volume a bit
        vol-             - lowers the volume a bit
        quit             - quits z!
        play [x]         - plays file [x] if not allready playing something,
                           otherwise it just adds to the playlist
        add [x]          - adds file [x] to the playlist
        addlist [x]      - adds all the files in the playlist file [x]
        addnext [x]      - adds file [x] after the current playing file
        shout [x]        - immediately plays file [x] then continues w/playlist
        addliststr [fn1;fn2;fn3;fn4;etc..]
                         - send a playlist (can be huge) to z!
        clearlist        - clears the playlist
        writetodisk [fn] - save http stream to [fn] (no [fn] = stop writing)


the following commands return a value:

        status [x] - [x] can be: file, tag, info, uptime, id3, volume
        id3track   - returns id3 track field
        id3artist  - returns id3 artist field
        id3album   - returns id3 album field
        id3year    - returns id3 year field
        id3genre   - returns id3 genre field
        playtime   - returns the total song time
        timenow    - returns the current song time
        rawinfo    - returns a raw data structure with all the above info
        getlist    - returns a (can be huge) string of files in the playlist
        filesize   - returns file size of the current track

heres the C structure for rawinfo:

struct rawinf {
    char fname[256], songinfo[256];
    char track[128], artist[128], album[128], comment[128];
    char year[6], playtime[10], timenow[10], genre[26], filesize[10];
};

source-code for accessing the named pipe can be found with the add-on's off
the main z! page