Drumkit format

---

! WARNING : the content of this page may be out of date (it will be updated soon) !

---

Upgrade after 0.9.6-beta2

Between 0.9.6-beta2 and 0.9.6-beta3, a significant change was made in the format of the drumkits. Warnings:

• there is no upgrade path for the drumkits downloaded in the oldest version to the newest version.
• in the newest version, the drumkits available for download from the official server, still correspond to the older format.

See https://github.com/hydrogen-music/hydrogen/issues/348 and https://github.com/hydrogen-music/hydrogen/issues/349 for discussion and more details.

The newest format can be found within the source code at data/xsd/drumkit.xsd.

Drumkit File Format

The .h2drumkit files are tarballs (gzip compressed tar files) with a directory structure like this:

  drumkit_name
  |-- 11385_atomwrath_KD-BD.flac
  |-- 13243_ianhall_chinese_cymbal.flac
  |-- 13244_ianhall_crash.flac
  |-- 13245_ianhall_floor_tom.flac
  |-- 13246_ianhall_hihat_closed.flac
  |-- 13247_ianhall_hihat_open.flac
  |-- 13248_ianhall_hihat_slushy.flac
  |-- 13249_ianhall_rack_tom.flac
  |-- 13250_ianhall_ride.flac
  |-- 13251_ianhall_snare_rim_shot.flac
  |-- 13252_ianhall_snare_side_stick.flac
  |-- 13253_ianhall_snare.flac
  |-- 13254_ianhall_splash.flac
  `-- drumkit.xml

Example: You have a folder called "drumkit_name" which holds all your files. Now type tar -czvf drumkit_name.h2drumkit drumkit_name/ to convert your folder into a hydrogen drumkit file.

drumkit.xml Format

drumkit.xml Example

<drumkit_info>
    <name>Drumset-0.1</name>
    <author>Some Guy</author>
    <info>Textual information about this drumkit.</info>
    <license>GPL</license>
    <instrumentList>
        <instrument>
            <id>0</id>

            <name>Kick</name>
            <volume>1</volume>
            <isMuted>false</isMuted>
            <isLocked>false</isLocked>
            <pan_L>1</pan_L>
            <pan_R>1</pan_R>

            <randomPitchFactor>0</randomPitchFactor>
            <gain>1</gain>
            <filterActive>false</filterActive>
            <filterCutoff>1</filterCutoff>
            <filterResonance>0</filterResonance>
            <Attack>0</Attack>

            <Decay>0</Decay>
            <Sustain>1</Sustain>
            <Release>1000</Release>
            <muteGroup>-1</muteGroup>
            <layer>
                <filename>11385_atomwrath_KD-BD.flac</filename>

                <min>0</min>
                <max>1</max>
                <gain>1</gain>
                <pitch>0</pitch>
            </layer>
        </instrument>
        <instrument>

            <id>1</id>
            <name>Snare</name>
            <volume>1</volume>
            <isMuted>false</isMuted>
            <isLocked>false</isLocked>
            <pan_L>1</pan_L>

            <pan_R>1</pan_R>
            <randomPitchFactor>0</randomPitchFactor>
            <gain>1</gain>
            <filterActive>false</filterActive>
            <filterCutoff>1</filterCutoff>
            <filterResonance>0</filterResonance>

            <Attack>0</Attack>
            <Decay>0</Decay>
            <Sustain>1</Sustain>
            <Release>1000</Release>
            <muteGroup>-1</muteGroup>
            <layer>

                <filename>13253_ianhall_snare.flac</filename>
                <min>0</min>
                <max>1</max>
                <gain>1</gain>
                <pitch>0</pitch>
            </layer>

        </instrument>
        <instrument>
            <id>2</id>
            <name>Snare Side Stick</name>
            <volume>1</volume>
            <isMuted>false</isMuted>
            <isLocked>false</isLocked>

            <pan_L>1</pan_L>
            <pan_R>1</pan_R>
            <randomPitchFactor>0</randomPitchFactor>
            <gain>1</gain>
            <filterActive>false</filterActive>
            <filterCutoff>1</filterCutoff>

            <filterResonance>0</filterResonance>
            <Attack>0</Attack>
            <Decay>0</Decay>
            <Sustain>1</Sustain>
            <Release>1000</Release>
            <muteGroup>-1</muteGroup>

            <layer>
                <filename>13252_ianhall_snare_side_stick.flac</filename>
                <min>0</min>
                <max>1</max>
                <gain>1</gain>
                <pitch>0</pitch>

            </layer>
        </instrument>

         ...

    </instrumentList>

</drumkit_info>

Misc

Read at this thread which contains some information about the drumkit format.