← Back to Interactive Map

config_reference

full parameter documentation for config.txt

where does config.txt come from?
1. after the boot chirps finish, hold pads 2+3. mounts the card as a plain USB drive
2. edit config.txt there in any text editor, then save
3. press boot. to apply
desktop/laptop only · see quickstart for the full boot sequence
saving config: D1 solid white = writing, wait for heartbeat, then press boot. to apply
don't eject the drive. ejecting just re-mounts it
factory_defaults
Pad x.1 LED 0
pad_0_*
HIDctrl+alt+↑
MIDINote 60
GPIO3
FuncLayer Up
Pad x.2 LED 1
pad_1_*
HIDalt+s
MIDINote 61
GPIO2
FuncSplit Section
Pad x.3 LED 2
pad_2_*
HIDalt+m
MIDINote 62
GPIO1
FuncMerge Section
Pad x.4 LED 3
pad_3_*
HIDctrl+alt+[
MIDINote 64
GPIO4
FuncTrim Container
Pad x.5 LED 4
pad_4_*
HIDo
MIDINote 65
GPIO9
FuncEnd of Container
Pad x.6 LED 9
pad_5_*
HIDperiod (.)
MIDINote 66
GPIO7
FuncNext Section
Pad x.7 LED 8
pad_6_*
HIDcomma (,)
MIDINote 67
GPIO6
FuncPrevious Section
Pad x.8 LED 7
pad_7_*
HIDalt+t
MIDINote 69
GPIO5
FuncRepeat Prev Tag
Pad x.9 LED 6
pad_8_*
HIDspace
MIDINote 70
GPIO10
FuncPlay Section
Pad x.10 LED 5
pad_9_*
HIDctrl+alt+↓
MIDINote 69
GPIO11
FuncLayer Down
Pad x.11 No LED
pad_10_*
HIDesc
MIDINote 70
GPIO18
NoteNear QR code
Pad x.12 No LED
pad_11_*
HIDtab
MIDINote 48
GPIO19
NoteNear logo

parameter_pattern

pad_X_parameter=value

Where X = config index (0-11). 0-indexed, one lower than the PCB's x.1–x.12 silkscreen labels. See factory_defaults above for the full PCB label → config key mapping. Only include the parameters you want to change. anything left out keeps its factory default.

parameters

ParameterValuesDescription
midi_note0-127MIDI note number (60 = middle C)
midi_velocity1-127Note velocity (loudness)
midi_channel1-16MIDI channel
hid_keysee special_keysKey or key combo (e.g., ctrl+alt+s)
led_brightness0-255Overall LED brightness
led_base_r0-255Base color red component
led_base_g0-255Base color green component
led_base_b0-255Base color blue component
led_touch_hue_shift-127 to +127Hue shift when touched

modifiers

ctrl alt shift gui
Combine with +. e.g., ctrl+alt+arrow_up or shift+f5
Maximum 2 modifiers currently supported.

special_keys

Navigation

arrow_up arrow_down arrow_left arrow_right home end page_up page_down

Function Keys

f1f2f3 f4f5f6 f7f8f9 f10f11f12

Common

tab enter esc space backspace delete

Punctuation

comma period minus equal [ ] \ ; ' ` /

example_config

# ═══════════════════════════════════════════════════════════════ # PAD 0 (x.1 on PCB) - "Layer Up" for d3 designer # ═══════════════════════════════════════════════════════════════ pad_0_hid_key=ctrl+alt+arrow_up pad_0_midi_note=60 pad_0_midi_velocity=127 pad_0_midi_channel=1 pad_0_led_brightness=30 pad_0_led_base_r=0 pad_0_led_base_g=0 pad_0_led_base_b=0 pad_0_led_touch_hue_shift=40 # ═══════════════════════════════════════════════════════════════ # PAD 5 (x.6 on PCB) - "Next Section" - Red base color # ═══════════════════════════════════════════════════════════════ pad_5_hid_key=period pad_5_led_base_r=255 pad_5_led_base_g=0 pad_5_led_base_b=0 # ═══════════════════════════════════════════════════════════════ # PAD 8 (x.9 on PCB) - "Play Section" / Space bar # ═══════════════════════════════════════════════════════════════ pad_8_hid_key=space