LoopMuse v1.03
by DDRKirby(ISQ)

==============
=Installation=
==============
Windows:
Extract from the zip file, then run LoopMuse.exe.

Linux:
Extract from the tar.gz file, make sure you have the correct dependencies installed, then run "./LoopMuse".
You'll need to install the following libraries (usually from your package manager):
SDL2 (libsdl2-2.0-0)
SDL2_image (libsdl2-image-2.0-0)
SDL2_ttf (libsdl2-ttf-2.0-0)
Note: The Linux build attempts to suspend PulseAudio using pasuspender in order to connect via ALSA directly.  To bypass this behavior, run "./LoopMuseProg" instead.

Mac OS X:
Open the dmg file, move the entire LoopMuse folder into your Applications folder using the provided symlink, and then run it from there.

==============
=Known issues=
==============
-The .wav file writer outputs a debug message to stderr whenever a new file is created.
-Higher buffer sizes cause timing inaccuracies.
-Bug that causes LoopMuse to fail when trying to open the audio device in some cases.
-Linux version suspends pulseaudio and connects via ALSA directly instead.

============================
=Frequently asked questions=
============================
Q: Where are the .wav files outputted to?
A: The same directory that the executable is in. For Windows, this means LoopMuse.exe, for Linux this means LoopMuse, and for OS X this means the LoopMuse.app package (this is why you should move the entire LoopMuse folder to your /Applications directory).

===========
=Changelog=
===========
*v1.03 - 11/20/18*
-Update to SDL2 and newer stk version, recompile everything (6+ years later)
-Fix dependencies to work correctly (especially OSX)
-Fix black screen on startup of OSX build on Mojave (not that the OSX build was working anyways)
-Decrease the minimum latency allowed (mostly for ALSA, and especially CoreAudio)
-Have Linux build use pasuspender to suspend PulseAudio to allow for direct ALSA connection

*v1.02 - 3/28/12*
-Removed the no-longer-needed sfx/rawwaves folder.
-Fixed a frequency calculation bug that caused all notes to be 20 semitones off (C's were Ab's).

*v1.01 - 12/22/11*
-Fixed a bug that prevented the Linux version from opening properly.
-Removed the dependency on SDL_mixer.
-Fixed a bug that caused a crash upon exiting if you entered by pressing enter and escape simultaneously.
-Fixed some rendering code that caused weird graphical bugs to appear in some cases.
-Reworked the echo implementation.  It now works consistently, and is a true echo line instead of a one-time repeat.
-Added .wav output support.  Click on the "Recording" button to start exporting to a .wav file.  The output file is automatically named according to the date and time of recording, with a new file created for each recording session.  .wav files are output into the same directory as the executable (or .app package in the case of OS X).
-You can now change the size of the audio buffer (and thus, the audio latency) in the main menu.  However, note that low audio buffer sizes may cause underruns, and large audio buffer sizes will cause both audio delay and timing inaccuracies (the former is unavoidable, the latter may eventually be fixed in an implementation rework).  The timing window for each step is automatically adjusted according to the selected buffer size.
-Changed click behavior to prefer left-clicks over right-clicks.  This allows you to "live play" an instrument by holding down the right mouse button while clicking the left mouse button to play.
-Tweaked the audio mixer's limiter algorithm slightly.

*v1.00 - 12/15/11*
-First release!

==================================================================
More info at https://www.ddrkirby.com/games/loopmuse/loopmuse.html