Note: This program is still in the very early development stage, and is
lacking in obvious features; the author is aware of this. Awave Studio is a
commercial package with many more capabilities, if one needs a comprehensive
tool to resave EFE instruments or their wavesamples to other formats.

The main purpose of this program is to convert Ensoniq EFE (ASR/EPS series)
instruments to standard WAV sound files.

This provides an alternative to manually sampling via the analog output, or
transferring wavesamples over MIDI by using tools such as Epsilon or Sample
Wrench.

EFE2WAV will batch convert as many EFEs as are supplied.

Both Windows and macOS are now supported, so use the commands within the
"macOS" folder when on macOS, and the commands within the "Windows" folder
when on a Windows operating system. The "tools" subfolders should never be
altered, moved, deleted, or otherwise touched.

On macOS, an "unidentified developer" message will typically appear when trying
to run any software not downloaded through the App Store. To avoid this, make
sure to use control-click (or right click) then "Open" on the first run. The
message will no longer appear on subsequent runs of the same program.

==========
CONVERSION
==========

- Move/copy all EFEs into the [EFE_IN] folder.

- Run the "EFE2WAV v0.40" command to extract all EFEs to WAV.

Each EFE will be extracted to its own sub-folder within the [WAV_OUT] folder.
All wavesamples from the EFE will be extracted, although any wavesample which
were just copies of other wavesamples will be skipped.

Simple parameters like root note, loop mode, and loop points will be intact.

Note: Not all EFEs hold instrument/wavesample data. Some EFEs are other
Ensoniq file types such as banks, songs, macros, or the operating system.
Any non-instrument EFE will be skipped, as there is nothing to extract.

==============
CONSIDERATIONS
==============

WAV format is not capable of holding advanced sampling metadata such as layer
structure. While the actual waveform data can be extracted in a 100% lossless
manner, any advanced parameters and instrument structure cannot be perfectly
preserved.
