Importer - peter-zenk/genDrumkit GitHub Wiki

Drum Kit Importer

Dummy Importer

To create a default skeleton this dummy importer exists that uses hard-coded settings.

Invocation:

genDrumkit --impFmt DUMMY

genDrumkit --impFmt DUMMY --kit_name ThisKit

Hydrogen Importer

This is the current default importer.

Hydrogen is an open source drum machine. The Hydrogen drum kit DB <kit_name>.h2drumkit basically is a (sometimes gzip'ed) tar archive containing the audio samples and a drumkit.xml file.

Mapping from Instrument to Audio Channel

The Hydrogen format does not contain mapping from instruments to audio output channel. This will be handled by the tool. There are two options to define the audio output channels and map the instrument outputs to the audio output channels.

By default the instruments will be generated with one internal output (mono) which can be connected to any of the (mono) audio channels.

If the source Hydrogen kit has stereo samples use option -hg_stereo and a left and a right internal output will be created for each instrument. Each of the external output channels will also be created as a left and a right output and the stereo instrument outputs can be mapped to these external stereo audio outputs.

Please note that the number of audio outputs might be restricted depending on the target format (DrumGizmo supports 16 audio outputs which is 8 stereo audio outputs)

The mapping is done in a CSV side file. Please also see page Map File

Proposed Work Flow

The proposed workflow is this:

  1. Check the Hydrogen file. Convert with default values.

  2. Run the tool to create the template map file.

  3. Edit the template map file and assign the instruments to outputs.

  4. Run the tool with the map file to create the drum kit.

  5. Test the generated drum kit with the target plugin (e.g. DrumGizmo).

Example Invocations

Convert Hydrogen DB with default parameters (and default mapping which might be useless due to many audio outputs.)

genDrumkit --hg_db <drum_kit>.h2drumkit

Create a map template CSV from the Hydrogen DB. This will generate a <drum_kit>.tmpl.csv file:

genDrumkit --hg_db <drum_kit>.h2drumkit -hg_mode TPL

Import a Hydrogen DB and export a drum kit in the default format.

genDrumkit --hg_db <drum_kit>.h2drumkit --channel_map <drum_kit>.csv

Back to Home

⚠️ **GitHub.com Fallback** ⚠️