1
Use Chrome or Edge
Studio requires the Web Serial API, which is only available in Chrome and Edge. Open Studio at https://studio.minimalmacropad.com/ in one of those browsers. Firefox and Safari are not supported and will not work regardless of other settings.
2
Use a data-capable USB-C cable
Many USB-C cables are charge-only and cannot carry data. Try a different cable — one that came with a phone, tablet, or other device that uses data transfer. A cable labeled as a data cable or USB 2.0/3.x cable is a safe choice. Charge-only cables will power the MinimalPad but Studio will not be able to see it.
3
Check the USB port
Try a different USB port on your computer. Avoid USB hubs if possible — connect the MinimalPad directly to a port on the machine itself. Some hubs do not reliably pass through serial devices.
4
Close other software using the serial port
If another application has the serial port open — such as a terminal emulator, the Arduino IDE, QMK Toolbox, or another firmware configuration tool — Studio cannot claim the port. Close those applications and try connecting again.
5
Unplug and reconnect
Disconnect the MinimalPad from your computer, wait a few seconds for the OS to release the port, then plug it back in. Return to Studio and try connecting again.
6
Confirm Studio-enabled firmware is installed
The standard firmware build does not include Studio support. Studio can only connect to a device running the
minimalpad_with_studio firmware. If you are unsure which firmware is installed, reflash with the correct build. See the firmware installation guide for instructions.