DOIO Megalodon Triple Knob Macro Pad on macOS 26 Tahoe

README.md

It was tricky to get the DOIO Megalodon Triple Knob Macro Pad (the one that supports Bluetooth, in my case) working on macOS 26 Tahoe (MacBook Air M2).

Hardware

It only charges and connects via 5V, i.e. a USB-A-to-C cable. A typical USB-C-to-C cable won't work.

The "B" on the back is for "Bluetooth". Pressing it makes the screen blink and probably puts the device in pairing mode?

The "R" is for "Reset". Pressing it supposedly reboots but does not reset. (Source)

Software

I could not get the online Via configurator working.

If you're daring, you can download Via 1.3.1 from the official (I hope) site:

• Direct link: http://doiokb.com/uploads/soft/20230522/1-2305220R1242U.dmg
• Linked from: http://doiokb.com/index.php?m=home&c=View&a=index&aid=250&lang=en

The daring part is that you'll need to disable protections to run it:

xattr -d com.apple.quarantine /Applications/VIA.app

Using the Via app

Seems like the device needs to be connected to the computer by cable (not Bluetooth).

The app will say "Searching for devices…" even after having been set up successfully before.

After each app relaunch, you need to switch to the "Design" tab and upload a .json file (provided in this Gist). Once you've done so, the "Configure" tab starts working.

To be able to configure lighting (keyboard RGB), the JSON file needs to include stuff for this, which the attached one does. It's based on one I found online and then had Claude Code add lighting support to.

You can't map some things (e.g. changing keyboard layers) to dial turning, presumably because those are not handled like real keypresses. You can map anything to dial presses.

You don't need to use macros for most key combinations. Pick "Any" in the "Special" section and you can input QMK keycodes such as HYPR(KC_X) for Shift+Ctrl+Opt+Cmd+X or LCAG(KC_X) for Ctrl+Opt+Cmd+X.

Bluetooth is pointless on this one

Bluetooth is pointless on this one unless you use it continuously. When you've not used it for a little while (a few minutes?), it goes into some power saving mode, and will ignore your first press. And maybe second and third – it takes it a few seconds to wake up.

This is not an issue when wired.

kb16b-02_V2_lighting.json

{
  "name": "DOIO",
  "vendorId": "0xFEED",
  "productId": "0x6060",
  "lighting": "qmk_rgblight",
  "matrix": {
    "rows": 5,
    "cols": 7
  },
  "layouts": {
    "keymap": [
      [
        "0,1",
        "0,2",
        "0,3",
        "0,4",
        {
          "x": 0.5
        },
        "4,6",
        "3,6",
        {
          "x": 1.5
        },
        "1,5",
        "0,5"
      ],
      [
        "1,1",
        "1,2",
        "1,3",
        "1,4",
        {
          "x": 1
        },
        "4,5",
        {
          "x": 2.5
        },
        "3,5"
      ],
      [
        "2,1",
        "2,2",
        "2,3",
        "2,4",
        {
          "x": 2.25
        },
        "1,6",
        "0,6"
      ],
      [
        "3,1",
        "3,2",
        "3,3",
        "3,4",
        {
          "x": 2.75
        },
        "2,5"
      ]
    ]
  }
}