- PCB Design:
Music Pad.kicad_pcbMusic Pad.kicad_schMusic Pad.kicad_pro
- Case Design:
Bottom.stepTop.step
- Keyboard Layout Styles:
keyboard-layout.jsonplate-2026-02-05T17_30_58.558Z.dxf
- Programs:
music_pad_firmware.pyspotify_monitor_app.py
| Quantity | Item | Notes |
|---|---|---|
| 1 | 3D Printed Case | Includes Bottom and Top files |
| 4 | M3x5mx4mm Heatset Inserts | |
| 4 | M3x16mm Screws | |
| 1 | 0.91 inch OLED Display | 4-pin version |
| 3 | DSA Keycaps | |
| 1 | Seeed XIAO RP2040 | |
| 3 | MX-Style Switches | |
| 1 | EC11 Rotary Encoder |
Download CircuitPython for XIAO RP2040 from circuitpython.org Double-press the reset button on your XIAO RP2040 to enter bootloader mode A drive named RPI-RP2 will appear Copy the downloaded .uf2 file to this drive The board will restart and appear as CIRCUITPYITPY
Download the CircuitPython library bundle from circuitpython.org/libraries (match your CircuitPython version) Extract the bundle Copy these folders/files to the lib folder on your CIRCUITPY drive:e:
adafruit_hid/ (entire folder) adafruit_displayio_ssd1306.mpy adafruit_display_text/ (entire folder)r)
Copy the music_pad_firmware.py firmware to the root of your CIRCUITPY drive The board will automatically restart You should see "Music Pad" and "Waiting for Spotify..." on the OLED displayay
Go to https://developer.spotify.com/dashboard Log in with your Spotify account Click "Create an App" Fill in:in:
App name: Music Pad Monitor App description: Monitors Spotify for Music Pad display Accept the terms and click "Create"e"
In your app dashboard, you'll see:
Client ID (copy this) Click "Show Client Secret" and copy itt
Click "Edit Settings" Under "Redirect URIs", add: http://localhost:8888/callback Click "Add" then "Save""
Download Python 3.8+ from python.org During installation, check "Add Python to PATH" Complete the installationon
Open Command Prompt (cmd) and run: bashpip install pyserial spotipy python-dotenvv
Create a folder for your Music Pad monitor (e.g., C:\MusicPadMonitor) Save the spotify_monitor_app.py file in this folderr
Create a file named .env in the same folder with your credentials: SPOTIPY_CLIENT_ID=your_client_id_here SPOTIPY_CLIENT_SECRET=your_client_secret_here SPOTIPY_REDIRECT_URI=RI=http://localhost:8888/callback Replace your_client_id_here and your_client_secret_here with the values from your Spotify app..
Connect your Music Pad to your computer via USB Wait for Windows to recognize the devicee
Open Command Prompt Navigate to your project folder::
bash cd C:\MusicPadMonitor
Run the monitor:
bash python spotify_monitor_app.py
The first time you run it, a browser window will open Log in to Spotify and authorize the app The browser will redirect to a page that may show "can't reach this page" - that's OK! Copy the entire URL from the address bar Paste it into the Command Prompt when asked Press EnterEnter