git-moss / ConvertWithMoss

Converts multisamples from a source format (WAV, multisample, KMP, wavestate, NKI, SFZ, SoundFont 2) to a different destination format.
https://www.mossgrabers.de/Software/ConvertWithMoss/ConvertWithMoss.html
GNU Lesser General Public License v3.0
198 stars 14 forks source link
converter multi-sample music samples

title: The ConvertWithMoss Manual author:

\pagebreak

Welcome to the ConvertWithMoss Documentation

This tool converts multisamples in a specific source format to a different destination format. Furthermore, it can create multisample files from plain AIFF and WAV files.

Additionally, the conversion process reads and writes metadata (name, category, creator, description and keywords) as well as envelopes and filter settings, if supported by the format. If the source format does not support metadata a guessing algorithm is applied based on the samples names.

Details about the specific converted parameters can be found in a spreadsheet.

Installation

Download and run the matching installer for your operating system. After that you can start the application ConvertWithMoss.

Note macOS

Read the macOS installation specifics for important notices!

Build from sources

Ensure to have the required JVM, JRE, JavaFX and Maven dependencies preinstalled and set the JAVA_HOME environment variable to specify which Java version to use; the minimum required version is 21. Then use mvn install command to start the build.

See also the various build scripts in this directory as references on how to build the documentation and/or the application source files.

For Linux (BSD not tested) there is also a Makefile for build and install with the usual make and make install commands.

Usage

  1. Select the source format on the left. Select a source folder, which contains one or multiple folders with multisamples in the selected source format. The files can also be located in sub-folders.
  2. Select the destination format. Select the output folder where you want to create the multisamples. This folder must be empty. You can add a non-existing folder to the name, which then is automatically created. E.g. you could select the Desktop and then add a folder Conversions.
  3. Press the Convert button to start the conversion. The progress is shown with notification messages in the log area, which you should check for potential errors like defect source files, skipped folder, etc.

Alternatively, press Analyse to execute the same process as Convert but does not write any files. Use this to check for errors before finally running the conversion.

Options