SIDPLAYER NEWS FILE #6  March 1986

this documentation file describes how to use the magic sid
machine, a utility for loading, playing, and cataloging
sidplayer songs.  msm will automatically load and play up to
144 songs, far more than you will probably be able to get on
a disk.  the program, and this documentation file, were
written by terry kryger.

the most recent version, msm 2.2, features an updated m/l
play routine provided by craig chamberlain.  among other
improvements, f-x defaults to 'on' for less background
noise.

when run, msm displays a menu of seven options:

  1. create or update a directory file

  2. choose songs from directory file

  3. choose songs (no directory file)

  4. play all songs in directory file

  5. play all songs on disk (no file)

  6. send directory file to printer

  7. end


create or update a directory file

the 'directory file' is not the same thing as the disk
directory. it is a special directory, originally created by
the msm program, of all the sidplayer songs on the disk.

when you select this option, the program will search for all
files on the disk having the '.mus' filename extension.  it
will ignore any files not having the extension, even if they
are sidplayer songs, so don't forget the '.mus' at the end
of the filename.  similarly, any non-sidplayer files (seq
files, for instance) that mistakenly have the .mus
extension, will be read into the directory but will not load
properly, causing the program to crash.

after all the sidplayer songs are found, you will have the
option to alphabetize the names for your song directory.  a
sequential file called 'sidcat' will then be written to the
disk.  having this directory file on the disk eliminates the
time-consuming process of checking the whole disk each time
you run the program.  use this option anytime you save
another song on the disk, to keep the file updated.


choose songs from directory file

when you select this option, the program will list all the
songs in the 'directory file' created with option 1.  if no
'sidcat' file exists, you will be reminded to create one.

the songs are displayed on screens of 26 songs each.  to
choose the songs, type in the letters corresponding to the
songs in the order you want to hear them.  the song names
will be highlighted as they are selected.  the same song can
also be selected to play more than once.

if more than 26 songs are on the disk, a reminder appears at
the bottom of the screen.  press the f7 function key to
bring up the next screen of titles.  the f7 key will cycle
through all the screens as many times as you wish, allowing
you to make selections each time.  when you return to a
screen, your previous choices will still be highlighted.

press the return key at any time to cancel your selections
and go back to the menu.  when you are finished choosing
songs, press the space bar to start playing.

you can stop any song while it is playing and go on to the
next selection by pressing the space bar.  pressing the
up-arrow key will cancel any remaining selections and return
you to the menu.

you may safely use this option after inserting a different
disk, as the current 'sidcat' directory file is loaded each
time the option is selected.


choose songs (no directory)

after searching the disk directory for .mus files, this
option works just like the above option.


play all songs in directory file

the songs will be played in alphabetical order if the song
directory was sorted.  otherwise they will be played in the
same sequence as they appear on the disk.


play all songs on disk (no file)

this option plays all the songs in same sequence as they
appear on the disk. the directory file is not used.


send directory file to printer

choose this option if you would like to print the names of
the songs in the song directory file.


end

when you are done playing songs, choose this option to exit
the program and return to basic.


if you are using the epyx fastload cartridge and find that
you are having trouble creating a directory file, unplug
(don't just disable) the cartridge for this operation.  it
will work fine for reading the files, but for some reason it
doesn't always like to write the sidcat file.  the mach 5
cartridge and (as far as i know) other fastloaders work
fine.

credit goes to dave schmoldt, who originally wrote the core
of this program for use with master composer files (magic
music machine).

undying thanks to craig chamberlain for his terrific book
"all about the commodore 64, volume two" published by
compute! books, which contains the sidplayer utilities.  i
particularly appreciate the support he continues to give by
way of new utilities, music, and advice.


terry kryger (terryk)

                          * * *