Strumboli

Turn your drawing tablet into a MIDI strumming controller

Github Logo

Configure your stylus pen buttons

Stylus Buttons

Configuration for stylus pen buttons. Most drawing tablets have one or two buttons on the stylus itself, providing quick access to common actions without interrupting your playing.

Settings

active

Type: boolean
Default: true
Description: Enable stylus button handling

Examples:

{
  "stylusButtons": {
    "active": true
  }
}

Set to false to disable stylus button actions.

primaryButtonAction

Type: string, array, or null
Default: "toggle-transpose"
Description: Action for primary stylus button (typically front button)

Examples:

Simple action:

{
  "stylusButtons": {
    "primaryButtonAction": "toggle-repeater"
  }
}

Action with parameters:

{
  "stylusButtons": {
    "primaryButtonAction": ["transpose", 12]
  }
}

Disabled:

{
  "stylusButtons": {
    "primaryButtonAction": null
  }
}

See Actions Reference for all available actions.

secondaryButtonAction

Type: string, array, or null
Default: "toggle-repeater"
Description: Action for secondary stylus button (typically back button)

Examples:

Simple action:

{
  "stylusButtons": {
    "secondaryButtonAction": "toggle-transpose"
  }
}

Action with parameters:

{
  "stylusButtons": {
    "secondaryButtonAction": ["transpose", -12]
  }
}

Disabled:

{
  "stylusButtons": {
    "secondaryButtonAction": null
  }
}

See Actions Reference for all available actions.

Configuration Example

{
  "stylusButtons": {
    "active": true,
    "primaryButtonAction": ["transpose", 12],
    "secondaryButtonAction": "toggle-repeater"
  }
}

Common Configurations

Octave Switching

{
  "stylusButtons": {
    "primaryButtonAction": ["transpose", 12],
    "secondaryButtonAction": ["transpose", -12]
  }
}

Repeater and Transpose

{
  "stylusButtons": {
    "primaryButtonAction": "toggle-transpose",
    "secondaryButtonAction": "toggle-repeater"
  }
}

Chord Changes

{
  "stylusButtons": {
    "primaryButtonAction": ["set-strum-chord", "G"],
    "secondaryButtonAction": ["set-strum-chord", "Am"]
  }
}

Related Documentation