Skip to content

This is repository where I documented the whole Music Pad that lets you stop, play and change music.

Notifications You must be signed in to change notification settings

kossa520/Music-Pad

Folders and files

NameName
Last commit message
Last commit date

Latest commit

456c024 · · Jan 7, 2026

History

35 Commits
Jan 6, 2026
Jan 6, 2026
Jan 6, 2026
Jan 6, 2026
Jan 7, 2026
Jan 6, 2026

Repository files navigation

Music Pad Images:

Preview:

preview

PCB Schemat:

image image

Case Schemat:

image image

Project Requirements

File List

  • PCB Design:
    • Music Pad.kicad_pcb
    • Music Pad.kicad_sch
    • Music Pad.kicad_pro
  • Case Design:
    • Bottom.step
    • Top.step
  • Keyboard Layout Styles:
    • keyboard-layout.json
    • plate-2026-02-05T17_30_58.558Z.dxf
  • Programs:
    • music_pad_firmware.py
    • spotify_monitor_app.py

Part List

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

Setup Guide

1. Install CircuitPython

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

2. Install Required Libraries

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)

3. Upload Firmware

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

Part 2: Set Up Spotify API

1. Create Spotify Developer Account

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"

2. Get Your Credentials

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""

Part 3: Install Windows Monitor App

1. Install Python

Download Python 3.8+ from python.org During installation, check "Add Python to PATH" Complete the installationon

2. Install Required Packages

Open Command Prompt (cmd) and run: bashpip install pyserial spotipy python-dotenvv

3. Create Project Folder

Create a folder for your Music Pad monitor (e.g., C:\MusicPadMonitor) Save the spotify_monitor_app.py file in this folderr

4. Create Configuration File

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..

Part 4: Run the Monitor

1. Connect Your Music Pad

Connect your Music Pad to your computer via USB Wait for Windows to recognize the devicee

2. Start the Monitor

Open Command Prompt Navigate to your project folder::

bash cd C:\MusicPadMonitor

Run the monitor:

bash python spotify_monitor_app.py

3. First Time Setup

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

About

This is repository where I documented the whole Music Pad that lets you stop, play and change music.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages