Skip to content

João Macropad is a 7 key macropad with 2 rotary encoders, an OLED Display. It also has 7 SK6812 MINI-E LEDs, and uses QMK firmware

Notifications You must be signed in to change notification settings

jsilvateactm2528/Blueprint-Macropad-jsilvateactm2528

Folders and files

NameName
Last commit message
Last commit date

Latest commit

00cf86b · · Jan 9, 2026

History

28 Commits
Jan 7, 2026
Jan 9, 2026
Jan 7, 2026
Jan 9, 2026

Repository files navigation

Blueprint-Macropad-jsilvateactm2528

João Macropad is a 7 key macropad with 2 rotary encoders, an OLED Display. It also has 7 SK6812 MINI-E LEDs, and uses QMK firmware

I spend a lot of hours on this build (I forgot to keep track of the time), because I'm new in this area and this is my first project.

João Macropad is a compact macropad featuring 7 mechanical keys, 2 rotary encoders, a OLED display, and 7 rgb leds.

image

It was designed as a personal open-source hardware project.

Features

  • 7 mechanical keys (For macros)
  • 2 EC11 rotary encoder with push button (One change volume and mute and the other rotate to move up and down a list of options on the OLED screen and press to select one of the options.)
  • 4 pin 128x32 OLED display (At the moment, I don´t know for sure what options I will have in the display.)
  • 7 SK6812 MINI-E LEDs (Just to illuminate the macropad.)
  • Seeed Studio XIAO microcontroller
  • QMK firmware

PCB

I used Kicad and it's a great program

  • Shematics
  • Pcb
  • 3d view of the top and botom part of the pcb
image image image image

Case

The case was designed to be compact, simple, and functional, with easy access to all components from the top.

image image image

Firmware

I used QMK for all of it

  • One of the rotary encoder changes volume, press to mute and the other move up and down a list of options on the OLED screen and press to select one of the options.
  • The 4 keys currently act as macros.
  • The OLED will have a list of shortcuts (plan on ading the list via a windows app)
  • The LEDs are normally changing between red, blue, green, and yellow.

BOM

  • 7x MX-Style switches
  • 7x Keycaps
  • 4x M3x5x4 Heatset inserts
  • 4x M3x16mm screws
  • 9x 1N4148 Diodes.
  • 7x SK6812 MINI-E LEDs
  • 1x 0.91" 128x32 OLED Display
  • 2x EC11 Rotary Encoder
  • 1x XIAO RP2040
  • 1x Case (2 printed parts)
  • 1x Custom pcb

About

João Macropad is a 7 key macropad with 2 rotary encoders, an OLED Display. It also has 7 SK6812 MINI-E LEDs, and uses QMK firmware

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published