Looping Audio Converter 3.0

This application acts as a frontend to other programs and libraries, and allows conversion between a variety of looping audio formats.

Supported importers:

Supported exporters:

(Note: some exporters have one or more "preferred importers" - these importers will be tried first, and they may allow LoopingAudioConverter to skip re-encoding the audio data.)

The source code to Looping Audio Converter is released under the GNU LGPL, version 3 or later.

Looping Audio Converter does not do any encoding or decoding itself of any format besides WAV. Other formats are handled by other applications or other .NET libraries, which do the bulk of the work.

You will need write access to the folder that the application is running in for it to store temporary WAV files.

Options available on the startup screen:

• Only files ending with: This option will remove any file not ending with the given extension from the list when you click Filter. Useful after you use the "add folder" button to add all files in a folder, recursively.
• Input directory: Used in conjunction with the "Add Folder" workflow; allows Looping Audio Converter to more accurately mirror the structure of subdirectories under the original input directory.
  
• Output directory
• To keep part of the original path, use one or more asterisks in the output path.
  For example, an input file of "C:\Music\The Golden Bubbles\Seventy-Two\10 Mpls.m4a" and an output path of "./output/*/*" will result in the file "./output/The Golden Bubbles/Seventy-Two/10 Mpls.brstm". Since there are two asterisks in this example, the last two directory names of the original file's path are used.
  
• Audio effects
  
• Convert to mono: combines all audio channels into one to save space
• New sample rate (Hz): a sample rate to downsample to (unless the input file is at that rate or lower, in which case it will not be changed); this also saves space but comes with a noticeable reduction in audio quality
• Amplify (dB or amplitude ratio): changes the volume of the audio. In dB, negative values reduce the volume. For amplitude ratio, use 2 to double the volume or 0.5 to cut it in half.
• Adjust pitch (semitones): adjusts the pitch up or down without affecting the tempo. Twelve semitones = one octave.
• Adjust tempo: makes the audio faster or slower without affecting the pitch. (Lowering the tempo may also result in a lower sample rate.)
  
• Loop options
  
• Keep as is: Loop points will be kept in input files that have them, and will not be added to files that do not.
• Remove loop information if present: All input files will be treated as non-looping.
• Add loop information if missing (start-to-end loop): Any input files that are non-looping or lack loop information will be looped start to end in the output.
• Ask for non-looping files: The audio import dialog from BrawlCrate will be shown for each input file without loop information after decoding so you can specify your own loop point.
  
• Ask for all files: The audio import dialog from BrawlCrate will be shown for all input files. For looping files, the loop point will be pre-populated.
  
• Channel export options
• Put all channels in one file: keeps the channel count as-is, even if there are more than two channels (left and right).
  
• Put each pair of channels in its own file: In video game music files, multiple channels sometimes correspond to different parts of a level (e.g. Klonoa) - use this option to export those parts separately. If the number of channels is odd, the last channel will be exported on its own.
• Put each channel in its own file: With this option, even stereo files will be split up.
• Output format: see above.
• Options: Audio quality options for encoding.
• Export whole song: exports from the beginning of the track through at least one loop and with an optional amount of fade-out time at the end. The text in "suffix" will be appended to the filename.
• Write looping metadata: WAV, Ogg Vorbis, and the Nintendo formats (e.g. BRSTM) all support looping, so by default, the loop start and end points will be encoded in the output file, and audio players (usually special apps or video games) will be able to take advantage of this information. If you don't want this information to be included (i.e. you want the song to always loop a certain amount of times, and not indefinitely), uncheck this box.
  
• Export segment before loop: exports the section from the beginning of the track until the loop start point. The text in "suffix" will be appended to the filename.
• Export loop segment: exports the section from the loop start until the loop end. The text in "suffix" will be appended to the filename.
• Skip re-encoding when possible: Choosing this option allows Looping Audio Converter to skip re-encoding audio in certain circumstances.
• Load Options and Save Options: These buttons allow you to load and save the options listed above to an .xml file. If there is a file in the current directory named LoopingAudioConverter.xml when the program starts, it will try to load options from this file automatically.

Command line arguments:

• Specify --auto to start the conversion automatically and close the program when it is complete.
• Specify an .xml file to set the conversion settings. You can export an .xml file from Looping Audio Converter with "Save Options".
• All other command line arguments will be treated as input files.

These command line arguments might be removed or modified in future versions.

If you just want to convert between WAV and VGAudio-supported formats like BRSTM, try VGAudioCli.

Each line should have the format:

{loop-start} {loop-end} {filename}

For example:

853168 5087322 41 Carefree Action.wav

Looping Audio Converter will pick up on this file if it exists. To prevent a song from looping, use a negative number as the loop start value.