ConvertWithMoss
Converts multisamples in a specific source format to a different destination format. Furthermore, it can create multisample files from plain WAV files.
The conversion process reads and writes metadata (name, category, creator, description and keywords) if supported by the format. If the source format does not support the information a guessing algorithm is applied to the name.
Furthermore, samples can be grouped into groups and key ranges. Each sample can have 1 or no loop and parameters for pitch and different playback parameters.
Supported formats
The following multisample formats are supported as the source format:
- Akai MPC Keygroups (*.xpm)
- Bitwig Studio multisample (*.multisample)
- DecentSampler (*.dspreset, *.dslibrary)
- Korg KMP/KSF (*.KMP)
- Korg wavestate/modwave (*.korgmultisample)
- Native Instruments Kontakt (*.nki) 1-4
- SFZ (*.sfz)
- SoundFont 2 (*.sf2)
- WAV files (*.wav)
The following multisample formats are supported as the destination format:
- Akai MPC Keygroups (*.xpm)
- Bitwig Studio multisample (*.multisample)
- DecentSampler (*.dspreset, *.dslibrary)
- Korg KMP/KSF (*.KMP)
- Korg wavestate/modwave (*.korgmultisample)
- Native Instruments Kontakt (*.nki) 1
- SFZ (*.sfz)
- WAV files (*.wav)
See README-FORMATS.md document for more details. Even more details about the specific converted parameters can be found here:
Installation
Download and run the matching installer for your operating system. After that you can start the application ConvertWithMoss.
Note
macOS users should read README-MACOS.md document 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 17.
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
- 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.
- 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.
- 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
- Renaming: Allows to rename multi-samples. Enable the checkbox to use this feature. If enabled select the file which contains the mapped names. The file is a simple text file in UTF-8 format (important if non-ASCII characters are used!). Each row contains one mapping. A mapping consists of 2 names separated either by ';' or ','. E.g. a row which contains "AcPno;Acoustic Piano" would name a multi-sample with the name "AcPno" into "Acoustic Piano" as output.
- Create folder structure: If enabled, sub-folders from the source folder
are created as well in the output folder. For example, if I select my whole
"Sounds" folder, there are sub-folders like
Sounds\07 Synth\Lead\01W Emerson'70 Samples. In that case the output folder would contain e.g.07 Synth\Lead\01W Emerson'70.multisampleif Bitwig multisample is selected as the destination format. - Add new files: Starts the conversion even if the output folder is not empty but only adds files which are not already present.
- Dark Mode: Toggles the user interface between a light and dark layout.