=======================================
The Big Red MidiSynth Jukebox
=======================================
INFO FOR USING THIS HYPERSTUDIO IIGS 
AS A SYNTHLAB JUKEBOX STACK
=======================================
BEFORE YOU CAN LISTEN TO THE JUKEBOX
=======================================

Before you can use this jukebox to play
MidiSynth songs, you'll need to copy
TOOL35 from this disk onto your IIGS
System Disk, or your hard disk drive.
It will need to be copied into your
*/SYSTEM/TOOLS folder. Please use the
Finder or other GS/OS compatible copy
program to copy the file. Once you've
copied TOOL 35 to the proper folder on
your boot disk, you'll need to re-boot
your system. Only then will the jukebox
work properly.

(NOTE: If you boot up your System from
3.5" disks, you may need to create a
special version of the IIGS System
Master to run this jukebox properly, as
Tool 35 is 24.5K in size, and you may
not have that much free disk space
available. If you do run out of disk
space copying Tool 35 to your startup
disk, try making a complete copy of
your IIGS System Disk, and once you
have made that copy, just start
deleting non-essential files from the
copy of your System.Disk. Feel free to
delete BASIC.SYSTEM and BASIC.LAUNCHER
as those are only needed for ProDOS 8
programs. That should give you plenty
of free disk space.)

The Big Red MidiSynth Jukebox was
created using HyperStudio, but because
MidiSynth was created after HyperStudio
was released, we had to patch the
run-time version of HyperStudio that
you'll find on this disk. For your
ease, that file is re-named JUKEBOX. In
order to run this jukebox properly,
you'll need to launch the jukebox, from
the Finder, by double clicking on that
file. DO NOT use your version of
HyperStudio to open this stack. Use
only the supplied file.

Apparently, MidiSynth songs and
digitized sounds cannot co-exist in a
stack. So, if you use your copy of
HyperStudio to run this MidiSynth
Jukebox, and then open another
HyperStudio stack that contains
digitized sound files, HyperStudio may
crash on you. The patched version on
this disk can run HyperStudio stacks
that contain both MidiSynth songs and
Digitized sounds.

USING THE JUKEBOX 
=======================================

I tried to make this as easy as
possible. Just get to the song list
screen, and click on one of the listed
songs. Sit back and enjoy.  Click on
the STOP icon to stop the music. Click
on the Home icon to return to the title
screen. You can quit using the Jukebox
at any time by just pressing Open-Apple
Q (hold the Open Apple key down and
depress the Q key).

You can also use this jukebox to play
songs located on other BRCC MidiSynth
disks, or disks you get from other
sources. If you purchase other song
disks from BRCC, you'll be able to use
this program to listen to the songs on
those disks, as we've added an option
to play any MidiSynth song on any disk.
You'll notice a button at the bottom of
the song list screen that says "LOAD
SONG FROM ANY DISK". If you click
there, a standard file selection dialog
box will appear, and you can choose the
song you want to play from that dialog
box. That song can be located on any
disk.

If playing songs from other disks, it's
very important to remember that as soon
as you click that button, the program
will attempt to load a necessary file
from the same disk that contains the
Jukebox. That's no problem whatsoever
if you're running the Jukebox from a
hard drive, or if you have more than
one 3.5" disk drives. If you have only
a single 3.5" disk drive, make sure you
follow the instructions below.

If you do have a hard drive, you can
create a folder named /SL01, and put
all the files from this disk in there,
and then when you acquire new MidiSynth
songs, you can just copy them to that
same folder. Or, you can put those
other songs anywhere. It doesn't really
matter.

If you have more than one 3.5" disk
drive, when you want to access songs
from other disks, just make sure that
this disk is in Drive 1, and your song
disk is in Drive 2.

If you have only a single 3.5" drive,
leave the disk with the Jukebox in your
disk drive while clicking on the "load
song from any disk" option, and wait
until the standard dialog box appears.
Once it does, you can safely remove
this disk, and insert your other
MidiSynth song disk. Then, click on the
"DISK" option, and when your disk with
MidiSynth songs appears in that dialog
box, just click on the song name, and
it'll play. Just remember that if you
remove this disk before the file dialog
box appears, the program will just
"hang".

VERY IMPORTANT INFORMATION IF YOU HAVE
ONLY ONE 3.5" DISK DRIVE
=======================================

First off, you're going to experience a
lot of disk swapping when using the
BRCC Jukebox. Of course, you will be
prompted whenever you do need to swap
disks. Due to the way GS/OS works, you
are going to experience one "oddity"
when running the jukebox. Whenever you
click on a song title from the song
list, the first thing the program is
going to do is try to locate your
System.Disk so it can load in TOOL 35.
However, once the Tool is loaded,
you'll be returned to the Song List
screen. If, for any chance, you are
greeted with silence, just click again
on the song title. It should play, at
that point, with no problem.

Sorry. I tried to make this jukebox as
"bullet proof" as possible, yet that is
one problem I was unable to overcome.
So, again, if you have only one 3.5"
disk drive, here's the procedure to
follow: click on a song title. When
prompted, insert your System Disk so
that Tool 35 will load. When returned
back to the song list screen, make sure
this disk is in your 3.5" disk drive,
and then click on the same song title a
second time.

When playing songs from other disks,
you're also going to run into this same
problem. The Jukebox DOES work, but you
will have lots of disk swapping to do,
and you will have to click on song
titles twice. The first time you do,
the Jukebox will load Tool 35, and then
you'll have to go through the same
procedure again, picking the song title
from the dialog box. As the creator of
this Jukebox, I realize that it is a
little awkward to use with only a
single 3.5" disk. However, please don't
let these "oddities" get the best of
you. The Jukebox does work, but the
first time you use it, it'll take some
getting used to.

CREDITS 
=======================================
 
I'd love to be able to take sole credit
for creating this Jukebox that plays
MidiSynth Songs, but, want to give
credit where credit is due:

Thanks to Roger Wagner. This jukebox
was created using HyperStudio. It also
contains Xcmd's that are copyrighted by
Roger Wagner, used of course, with
permission. It also uses routines from
Roger Wagner's Xcmd Library #1, and the
Master Xcmd comes from the HyperStudio
Xcmd license package.

Thanks to Mike Nuzzi of Triad Ventures
for releasing ClipTunes, the first in
Triad Ventures ClipStuff series of
add-on products for both HyperStudio
and HyperCard. ClipTunes includes an
Xcmd that allows MidiSynth tunes to be
played from within either hypermedia
program. I couldn't have created this
jukebox without that Xcmd. If you'd
like the ability to create a jukebox
like this, you can easily do so using
ClipTunes.

By the way, the ClipTunes Xcmd is
embedded in the stack using Roger
Wagner's Xcmd Manager.

Thanks to John Wrenholt for planting
the seed of the idea.

Thanks also to my good friend Al
Switzer for providing me with many of
the songs.

Thanks also to America Online,
CompuServe and GEnie. I downloaded a
number of these songs from those online
networks.

WARNING: This disk contains materials
that are copyrighted. Tool 35 is
copyrighted by Apple Computer Inc. The
HyperStudio run-time module, and the
HS.XCMD are copyrighted by Roger Wager.
The embedded MidiSynth Xcmd are
copyrighted by Triad Ventures.