This is LoopAuditioneer 0.8.1.1
Copyright (C) 2011-2015 Lars Palo
Released under a GNU/GPL 3 license, see LICENCE.txt



LoopAuditioneer is a software for evaluating loops and cues existing in wav 

file metadata. It's envisionaged to be useful for sample production for 
virtual
pipe organs, like GrandOrgue software. LoopAuditioneer can now find 
loops 
by itself also, both in single file mode and in batch processing. But
of course you can still use other software like Nick Appletons free Autoloop 
for other looping options.


This package is a binary win32 (x86) port package cross-compiled from Linux
with mingw-w64. The source code for LoopAuditioneer is available at 
http://sourceforge.net/project/loopauditioneer by use of subversion.

The icons in the bin folder are created by the LoopAuditioneer author.


CREDITS
-------

This program makes use of libsndfile, originally written by Erik de Castro Lopo
and 
avaiable at http://www.mega-nerd.com/libsndfile/. Is provided here locally 
as the version used includes non-official modifications (like the ability to 
handle cue points) that the LoopAuditioneer author has added, but not yet

been officially approved and included in the library. 

RtAudio, by Gary P. 
Scavone (http://www.music.mcgill.ca/~gary/rtaudio/) is used 
for audio output.

LoopAuditioneer uses some FFT routines taken from the Audacity source. The pitch
detection algorithm for the time domain is taken and adapted from a discussion 
on the GrandOrgue mailing list.



In the icons/ directory resides the icons used by the program. The complete set

is available at http://www.small-icons.com/packs/24x24-free-pixel-icons.htm and

distributed under a Creative Commons 3.0 license.



LoopAuditioneer uses wxWidgets, available at http://www.wxwidgets.org/, though
it's statically linked in this package so no other software needs to be 
installed to run this program.


USE OF THE SOFTWARE:
--------------------

Keep the original folder layout! In the bin folder the executable resides. Just
click on it (or create a shortcut to it) and the program should start.



In the 0.8.1.1 release the playback of 32 bit float files is fixed. Also the
loopsearch is now aware of already present loops in the file and takes them

into account when searching for new loops.

With the 8.1 version many changes are introduced. It's possible to do
crossfades as a batch process, a few of the batch processes are re-worked to be
more useful in providing lines for a GrandOrgue ODF. A complete help is now
built into the program. It's possible to save a file and open next in the file
list to speed up work by reducing the amount of operations needed. A few bug
fixes are also included. Also a few of the loop search settings parameters have
increased range now.



The 0.8 version series introduce a new approach to file listing in a listctrl

instead of a listbox to allow multiple columns showing beside the file name the

number of loops, cues, the Midi note and pitchfraction of the files. The

shortcut keys were modified so that the mostly used ones are placed better for

lefthand only usage. Navigation between files in the listctrl and between loops

and cues can also now be done with keyboard keys. Many of the settings are now

saved to a config text file to allow the program to remember user settings from

one session to another. Playback of only the loop part of a sample is also now
possible.

With the 0.7.5 release the loop finding parameters have been modified to have
larger span to increase possibilities to find loops even in very difficult
samples. A brute force option was added that will use a different strategy for
the loop collection and selection that should result in the best possible loops
found but also will take longer to complete the search process. Now it's also
enforced that, if more than one loop is found, all found loops must overlap at
least one other loop. Also the loop finding parameters now are shared between
single mode and batch mode which means that any adjustments must be done in the
main window.

As of the 0.7 version series it's now possible to modify the audio data in the
file. New features include the possibility to crossfade loops in a few
different manners and a new dialog in which one can see the waveform overlayed
at the looppoints. A popup menu is now avaliable when one right click on a loop.
Through that context menu it's possible to edit the loop, crossfade it or view
the magnified waveform overlayed at the looppoint. A possibility to cut and fade
in/out has been added both in single file mode and in batch processing.

It's possible to auto-detect the pitch of the sample and store this information
as midi note and pitch fraction in the file. There is two different methods for
detecting the pitch, one in frequency domain (using FFT) and one in time domain.
For single notes of medium to lower pitch the time domain detection is more 
accurate but for mixtures and higher pitches (about the 072-C of a 8' stop) the
FFT method gives better results. It's also possible to manually set the pitch
information to the file. A second FFT based detection (harmonic product
spectrum) with a slightly different approach gives additional options.

All menu commands now have keyboard shortcuts.

To autosearch for loop points use the Yin-Yang icon (or autoloop settings) to
adjust the parameters for the loop searching, then click on the magnifying glass
to execute the search.

The gear icon opens a batch processing dialog where all .wav files in the source
folder will be processed and saved into the target folder. It's possible to have
the source folder and the target folder the same.

Now it's possible to add cue markers by right clicking on the waveform at the
position one wants to have the marker at. It's also possible to edit the position
by left clicking on the marker flag and then left click again at the desired new
position.

A new feature is the possibility to add new loops from the toolbar or menu. It's
also possible to edit existing loops by right clicking on the loop table row 
that correspond to that loop and select Edit loop from the popup menu.

It's also possible to boost the playback volume to better hear softer samples.

For a more complete manual see: 
http://loopauditioneer.sourceforge.net/userguide.html




CONTACT THE AUTHOR:

-------------------



You can contact the author on larspalo AT yahoo DOT se.
 Feedback and bug 
reports are welcome either by e-mail or at sourceforge.