skills/import-drum-score/references/kit-reference.md

# Drum kit reference

Generated from `src/kit.ts`. Do not edit this file manually.

## X-notehead staff-position ladder

Use the source's printed legend or drum key when present. Otherwise use this generated Obsidian Drum Notation convention. Determine ledger-line evidence before using rhythmic context; repeated hi-hat rhythm must not override a distinct vertical cluster.

| Instrument rows | VexFlow key | Staff position | Ledger-line evidence |
| --- | --- | --- | --- |
| Stack (`STACK`) | `d/6/X` | space above the second ledger line | two ledger lines below the notehead |
| China (`CHNA`) | `c/6/X` | second ledger line above the staff | two ledger lines; the second crosses the notehead |
| Splash (`SP`) | `b/5/X` | space above the first ledger line | one ledger line immediately below the notehead |
| Crash (`CR`) | `a/5/X` | first ledger line above the staff | one ledger line crosses the notehead |
| Open hat (`OH`), Half-open hat (`HO`), Hi-hat (`HH`) | `g/5/X` | space above the top staff line | no ledger line |
| Ride (`RD`) | `f/5/X` | top staff line | no ledger line |
| Cowbell (`CB`) | `e/5/X` | fourth staff space | no ledger line |
| Rim (`RS`) | `c/5/X` | third staff space | no ledger line |
| Hi-hat foot (`HF`), Hi-hat foot splash (`HFS`) | `d/4/X` | space below the bottom staff line | no ledger line |

```json
[
  {
    "id": "crash",
    "label": "Crash",
    "aliases": [
      "cr",
      "crash",
      "cc",
      "crash cymbal"
    ],
    "notationVoice": "upper",
    "vexKey": "a/5/X",
    "midi": 49,
    "color": "#d97706",
    "playback": "crash",
    "staffPosition": "first ledger line above the staff",
    "notehead": "x",
    "requiresLedgerLine": true,
    "ledgerLines": {
      "count": 1,
      "relation": "through-notehead",
      "evidence": "one ledger line crosses the notehead"
    }
  },
  {
    "id": "splash",
    "label": "Splash",
    "aliases": [
      "sp",
      "splash",
      "splash cymbal"
    ],
    "notationVoice": "upper",
    "vexKey": "b/5/X",
    "midi": 55,
    "color": "#f59e0b",
    "playback": "splash",
    "staffPosition": "space above the first ledger line",
    "notehead": "x",
    "requiresLedgerLine": true,
    "ledgerLines": {
      "count": 1,
      "relation": "below-notehead",
      "evidence": "one ledger line immediately below the notehead"
    }
  },
  {
    "id": "china",
    "label": "China",
    "aliases": [
      "chna",
      "china",
      "china cymbal"
    ],
    "notationVoice": "upper",
    "vexKey": "c/6/X",
    "midi": 52,
    "color": "#ea580c",
    "playback": "china",
    "staffPosition": "second ledger line above the staff",
    "notehead": "x",
    "requiresLedgerLine": true,
    "ledgerLines": {
      "count": 2,
      "relation": "through-notehead",
      "evidence": "two ledger lines; the second crosses the notehead"
    }
  },
  {
    "id": "stack",
    "label": "Stack",
    "aliases": [
      "st",
      "stack",
      "stack cymbal"
    ],
    "notationVoice": "upper",
    "vexKey": "d/6/X",
    "midi": 52,
    "color": "#c2410c",
    "playback": "stack",
    "staffPosition": "space above the second ledger line",
    "notehead": "x",
    "requiresLedgerLine": true,
    "ledgerLines": {
      "count": 2,
      "relation": "below-notehead",
      "evidence": "two ledger lines below the notehead"
    }
  },
  {
    "id": "ride",
    "label": "Ride",
    "aliases": [
      "rd",
      "ride",
      "rc"
    ],
    "notationVoice": "upper",
    "vexKey": "f/5/X",
    "midi": 51,
    "color": "#b45309",
    "playback": "ride",
    "staffPosition": "top staff line",
    "notehead": "x",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "ride-bell",
    "label": "Ride bell",
    "aliases": [
      "rb",
      "bell",
      "ridebell",
      "ride bell"
    ],
    "notationVoice": "upper",
    "vexKey": "f/5/d2",
    "midi": 53,
    "color": "#92400e",
    "playback": "rideBell",
    "staffPosition": "top staff line",
    "notehead": "diamond",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "open-hat",
    "label": "Open hat",
    "aliases": [
      "oh",
      "openhat",
      "open-hat",
      "open hh"
    ],
    "notationVoice": "upper",
    "vexKey": "g/5/X",
    "midi": 46,
    "color": "#ca8a04",
    "playback": "hatOpen",
    "staffPosition": "space above the top staff line",
    "notehead": "x",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "half-open-hat",
    "label": "Half-open hat",
    "aliases": [
      "ho",
      "hho",
      "halfopenhat",
      "half-openhat",
      "half open hat",
      "half-open hat",
      "half open hi-hat",
      "half-open hi-hat"
    ],
    "notationVoice": "upper",
    "vexKey": "g/5/X",
    "midi": 46,
    "color": "#d4a017",
    "playback": "hatHalfOpen",
    "staffPosition": "space above the top staff line",
    "notehead": "x",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "closed-hat",
    "label": "Hi-hat",
    "aliases": [
      "hh",
      "ch",
      "close",
      "closed",
      "hat",
      "hihat",
      "hi-hat",
      "closedhat",
      "closed-hat"
    ],
    "notationVoice": "upper",
    "vexKey": "g/5/X",
    "midi": 42,
    "color": "#eab308",
    "playback": "hatClosed",
    "staffPosition": "space above the top staff line",
    "notehead": "x",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "hi-hat-foot",
    "label": "Hi-hat foot",
    "aliases": [
      "hf",
      "hhf",
      "fh",
      "foot hat",
      "hat foot",
      "hi-hat foot",
      "hihat foot"
    ],
    "notationVoice": "lower",
    "vexKey": "d/4/X",
    "midi": 44,
    "color": "#a16207",
    "playback": "hatFoot",
    "staffPosition": "space below the bottom staff line",
    "notehead": "x",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "hi-hat-foot-splash",
    "label": "Hi-hat foot splash",
    "aliases": [
      "hfs",
      "hhfs",
      "foot splash",
      "hat foot splash",
      "hi-hat foot splash",
      "hihat foot splash",
      "hi-hat splash",
      "hihat splash"
    ],
    "notationVoice": "lower",
    "vexKey": "d/4/X",
    "midi": 44,
    "color": "#854d0e",
    "playback": "hatFootSplash",
    "staffPosition": "space below the bottom staff line",
    "notehead": "x",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "snare",
    "label": "Snare",
    "aliases": [
      "sd",
      "sn",
      "snare"
    ],
    "notationVoice": "upper",
    "vexKey": "c/5",
    "midi": 38,
    "color": "#2563eb",
    "playback": "snare",
    "staffPosition": "third staff space",
    "notehead": "normal",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "rim",
    "label": "Rim",
    "aliases": [
      "rs",
      "rim",
      "rimshot",
      "xstick",
      "cross",
      "crossstick",
      "cross-stick"
    ],
    "notationVoice": "upper",
    "vexKey": "c/5/X",
    "midi": 37,
    "color": "#0891b2",
    "playback": "click",
    "staffPosition": "third staff space",
    "notehead": "x",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "high-tom",
    "label": "High rack tom",
    "aliases": [
      "ht",
      "rt",
      "rt1",
      "t1",
      "tom1",
      "rack",
      "rack tom",
      "high tom",
      "high rack tom"
    ],
    "notationVoice": "upper",
    "vexKey": "e/5",
    "midi": 50,
    "color": "#16a34a",
    "playback": "tomHigh",
    "staffPosition": "fourth staff space",
    "notehead": "normal",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "mid-tom",
    "label": "Mid rack tom",
    "aliases": [
      "mt",
      "rt2",
      "t2",
      "tom2",
      "mid tom",
      "mid rack tom"
    ],
    "notationVoice": "upper",
    "vexKey": "d/5",
    "midi": 47,
    "color": "#15803d",
    "playback": "tomMid",
    "staffPosition": "fourth staff line",
    "notehead": "normal",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "low-tom",
    "label": "Low rack tom",
    "aliases": [
      "lt",
      "rt3",
      "t3",
      "tom3",
      "low tom",
      "low rack tom"
    ],
    "notationVoice": "upper",
    "vexKey": "a/4",
    "midi": 45,
    "color": "#166534",
    "playback": "tomLow",
    "staffPosition": "second staff space",
    "notehead": "normal",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "floor-tom",
    "label": "Floor tom",
    "aliases": [
      "ft",
      "floor",
      "floor tom"
    ],
    "notationVoice": "upper",
    "vexKey": "g/4",
    "midi": 41,
    "color": "#14532d",
    "playback": "tomLow",
    "staffPosition": "second staff line",
    "notehead": "normal",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "low-floor-tom",
    "label": "Low floor tom",
    "aliases": [
      "lft",
      "ft2",
      "low floor",
      "low floor tom"
    ],
    "notationVoice": "upper",
    "vexKey": "e/4",
    "midi": 43,
    "color": "#052e16",
    "playback": "tomLow",
    "staffPosition": "bottom staff line",
    "notehead": "normal",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "kick",
    "label": "Kick",
    "aliases": [
      "bd",
      "kd",
      "kick",
      "bass",
      "bass drum"
    ],
    "notationVoice": "lower",
    "vexKey": "f/4",
    "midi": 36,
    "color": "#dc2626",
    "playback": "kick",
    "staffPosition": "first staff space",
    "notehead": "normal",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "second-kick",
    "label": "Second kick",
    "aliases": [
      "bd2",
      "kd2",
      "kick2",
      "bass2",
      "bass drum 2",
      "second kick",
      "second bass",
      "second bass drum"
    ],
    "notationVoice": "lower",
    "vexKey": "d/4",
    "midi": 36,
    "color": "#ef4444",
    "playback": "kick",
    "staffPosition": "space below the bottom staff line",
    "notehead": "normal",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  },
  {
    "id": "cowbell",
    "label": "Cowbell",
    "aliases": [
      "cb",
      "cowbell"
    ],
    "notationVoice": "upper",
    "vexKey": "e/5/X",
    "midi": 56,
    "color": "#7c3aed",
    "playback": "cowbell",
    "staffPosition": "fourth staff space",
    "notehead": "x",
    "requiresLedgerLine": false,
    "ledgerLines": {
      "count": 0,
      "relation": "none",
      "evidence": "no ledger line"
    }
  }
]
```