SYSTEM SOUND SHUFFLER, Ver 1.1

What it is
==========
Shuffler is designed to add some variety to system sound events in 
Windows 3.1.  It lets you designate multiple sound files for each system 
event and "shuffle" between them.  For instance, if you're tired of the 
same Windows Exit Sound every day, put Shuffler in your startup group and 
each time you start Windows Shuffler will randomly select one of your 
designated Windows Exit Sound files to replace the current one.


System Requirements
===================
Requires Windows 3.1 and a sound card and driver that will support *.Wav 
files.  In addition, to work with the design files, you'll need the VB 
Professional Toolkit.  If you do not have the Toolkit and you just want 
to run Shuffler, download the compiled program (Shufl2.zip), which 
includes the necessary runtime DLLs.  

In order to run Shuffler, the file cmdialog.vbx must be in your path. 
This file is included in Shufl2.zip.  


How it works
============
The main Shuffler window shows the following information for each system 
event:

  1.	The event name

  2.	The current sound file associated with the event (as designated 
	in the Win.ini file)

  3.	A list of additional sound files which you've associated with the 
	event (Shuffler chooses from this list when you give it the shuffle 
	command)

  4.	A check box indicating whether Shuffling is enabled for this event.  
	When you execute the Shuffle command, Shuffler will assign new 
	sound files only for those events where Shuffling is enabled.  By 
	default, Shuffling is disabled for all events.

The above information is stored in a file named "Shuffle.ini" in your 
Windows directory.

A brief explanation of the available commands follows:

	ADD FILE - Adds a sound file to the list of sound files associated 
	with the selected event.

	REMOVE FILE - Removes the selected sound file from the list of 
	sound files associated with the active event.  The sound file is 
	not deleted from disk.

	PLAY FILE - Plays the selected sound file.  You can also play a 
	sound file by double clicking on it in the Shuffle Files list box.
	
	SET CURRENT - Assign the selected sound file to the designated 
	system event.  This will update your Win.ini file.
	
	SHUFFLE - A new sound file is randomly selected from the list of 
	associated sound files for all events for which shuffling is enabled.


Command Line Arguments
=======================
Shuffler recognizes one argument - Shuffle.  This argument causes the 
Shuffle command to be executed without loading the Shuffler form.  If you've 
already configured Shuffler and you just want to shuffle your sound files 
every time you start Windows, put Shuffler in your Startup group with the 
Shuffle argument:

	Shuffler shuffle


Changes to Ver 1.1
=======================

If you had the original Shuffler, note that the following changes have been
made to version 1.1:

	1.  Shuffler now uses the Windows API function sndPlaySound to play
	sound files.  The previous version used the MCI player from the 
	VB Pro Toolkit and required the file MCI.VBX.  That file is no 
	longer required.

	2.  Shuffler no longer maintains a list of sound events in Shuffle.ini.  
	Instead, it reads the events from Win.ini when the program is loaded.
	The advantage to this change is that Shuffler will now pick up new 
	sound events as they're added to your system.  It also prevents 
	Shuffle.ini from getting out of sync with Win.ini



(c) Brian D. Stine, 1992
Uploaded courtesy of Brian Stine, Compuserve ID 73617,323

This is freeware.  It is distributed with only one restriction,
and that is that you may not sell the program or charge any fee
for distribution other than a disk copying fee of no more than $10.
