Candy BLE

Pocket Macropad · XIAO ESP32-C3 · BLE keyboard · not connected
Disconnected 

        

        

      

    

  


  
  

    

      

        
Flash the firmware over USB

        
Plug the numpad into this computer with a USB-C data cable, then click Install and pick the serial port.
           Works in Chrome, Edge, or Opera over HTTPS.

        
          
          Your browser can't flash — use desktop Chrome / Edge / Opera.
          This page must be served over HTTPS.
        
        
After flashing, switch to the Customize tab, hit Connect, and Read from device.

      

    

  


  
  

    

      

        
Two ways to configure

        
    
          
  • USB cable (this page): Customize tab → Connect → edit the 3×3 grid → Write to device. Instant.
    • 
          
  • Offline: edit here without a device, Export JSON, and Import it later.
    • 
        

      

      

        
Using it as a keyboard

        
After flashing, the device advertises as a Bluetooth keyboard (default name “Candy BLE”). Pair it from
           your phone/PC Bluetooth settings. Each key sends whatever you mapped. It deep-sleeps after the idle timeout
           and wakes when you press a key wired to GPIO0–GPIO5.

      

      

        
Key types

        
    
          
  • Key — a single key, optionally with Ctrl/Shift/Alt/Win. Holding auto-repeats.
    • 
          
  • Text / macro — types a whole string on press.
    • 
          
  • Media — volume, play/pause, next/prev (great for the “remote” use).
    • 
          
  • Layer — momentary (hold) or toggle, to fit more than 9 functions on the pad.
    • 
          
  • Hold action — give a key a second function on long-press.
    •