Skip to main content
The firmware is the software on the pad itself. Updating it adds features and fixes. Your keys, layers, dial, lights and Bluetooth pairings stay as they are, and you don’t need to pair again. The latest firmware is 0.9.0. It lets Studio for Mac give an app several layers and move between them with keys on the pad. It saves a dial you set about 2 seconds after your last change, and a layer with a long name no longer freezes the pad over Bluetooth. What changed in every version is in the release notes on GitHub.

On a Mac

Studio for Mac carries the latest firmware and installs it for you. When your pad needs it, the sidebar footer says so. Click it and follow the steps. That’s the easiest way, and the rest of this page is only for doing it by hand.

Update by hand

This works on any computer. You need a USB-C data cable.
1

Download the firmware

Open the latest release and download the .uf2 file under Assets, such as minimalpad_with_studio-v0.9.0.uf2.
2

Plug in the pad

Connect it to your computer with the data cable.
3

Put it in update mode

Press the small reset button on the board twice, quickly. A drive appears on your computer, called NICENANO on most pads.
4

Copy the file onto the drive

Drag the .uf2 file onto the drive. When the copy finishes, the drive disappears and the pad restarts with the new firmware. There’s nothing to eject or press.
5

Check it

Open Studio for Mac or Studio for browser and try a key.
Keys you never changed get the new firmware’s defaults. Keys you changed keep your setting.

Update mode

Update mode is how new firmware gets onto the pad. It’s always there, even if the firmware is broken, so you can’t break the pad by updating it.
  • To get in: press the reset button twice, quickly. The pad’s drive appears on your computer, and its keys and lights stop until it leaves.
  • To get out: press the reset button once. The pad restarts with the firmware it has, and the drive goes away.
If Studio for Mac says Your MinimalPad is in update mode, the pad got there by accident, from a double press or an update that didn’t finish. Press reset once and Studio connects as soon as it restarts.

If something goes wrong

  • Try another cable. A charge-only cable powers the pad but never shows the drive.
  • Change your timing. Press a little faster or slower. Some pads want a particular rhythm.
  • Plug straight into the computer, not through a hub, and try another port.
  • Check the pad’s lights. If they’re still on and its keys still type, it didn’t go into update mode. Press twice again.
That’s what should happen. The pad checks the file, installs it, restarts, and the drive goes away. Wait a few seconds.
Unplug the pad, wait ten seconds and plug it back in. Press reset twice, and copy the file again. You can repeat this as often as you need: update mode can’t be overwritten.
Switch them on once: hold the bottom-right key and press the dial. See Lights.
The update keeps your pairings, but a computer can take a moment. Press a key on the pad. If it still doesn’t reconnect, see Bluetooth problems.
Install the firmware again, with the steps above. A broken or wrong firmware is fixed by copying the right one on.Copying the firmware leaves the pad’s saved settings as they are: your keys, layers and pairings. That’s what keeps them through an update, and it means a problem in those settings survives it too. If the pad still doesn’t work after a fresh install, reset the saved settings.

Reset the saved settings

Only for a pad that still doesn’t work after you install the firmware again.
This erases everything the pad has saved: the keys you changed, layer names, the dial and lights you set, and every Bluetooth pairing. It can’t be undone.
1

Download the reset file

Download minimalpad_settings_reset.uf2. It isn’t firmware: it only erases.
2

Copy it onto the pad

Plug the pad in, press reset twice, quickly, and copy the file onto the drive that appears.
3

Install the firmware straight after

Press reset twice again and copy the latest firmware onto the drive, as in Update by hand. On its own, the reset leaves a pad that does nothing.
4

Pair your computers again

Remove the pad from each computer’s Bluetooth settings, then pair it again. In Studio for Mac, your app profiles need repair: accept it, or make them again.
Still not working? Email minimalpad@unbox-studio.com with what you tried.
The firmware is open source and built on ZMK. The source is on GitHub.