https://github.com/eezbotfun/8-key-macropad
8 key macro pad with 3.5 inch LCD Screen
https://github.com/eezbotfun/8-key-macropad
desktop-automation esp32s2 esp32s3 macropad macropad-hotkeys streamdeck
Last synced: 2 months ago
JSON representation
8 key macro pad with 3.5 inch LCD Screen
- Host: GitHub
- URL: https://github.com/eezbotfun/8-key-macropad
- Owner: eezbotfun
- License: mit
- Created: 2025-06-17T03:23:24.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-11-28T09:07:23.000Z (4 months ago)
- Last Synced: 2025-11-30T16:59:26.952Z (4 months ago)
- Topics: desktop-automation, esp32s2, esp32s3, macropad, macropad-hotkeys, streamdeck
- Language: JavaScript
- Homepage: https://www.eezbotfun.com
- Size: 38.3 MB
- Stars: 22
- Watchers: 1
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README



# What is it?
All the power of a Stream Deck, now with tactile mechanical keys, wireless freedom, and full DIY customization.
# Why make it?
The Stream Deck is cool and feature-rich, but its soft buttons lack the satisfying feedback of mechanical keys — and it can't go wireless. That's why we created a DIY alternative: a powerful macropad with tactile ***mechanical keys***, ***wireless connectivity***, and ***apperance customization***.
# Pros Compared to Stream Deck
***Wireless & Plug-and-Play*** :
No software or drivers needed; works instantly.
***HID Mode Support*** :
Functions as a standard HID device, allowing use even at computer startup — perfect for logging in without any background programs.
***Ultra-Fast Communication*** :
Uses ESP-NOW for low-latency, reliable performance.
***3.5-inch Full Display*** :
Provides a larger, more visually appealing screen for key functions and animations.
***Mechanical Keys*** :
High-quality mechanical switches offer a much better typing and tactile experience than Stream Deck, improving overall user interaction.
***Open Script Support*** :
Users can write scripts to achieve virtually any function, making it highly customizable and fun to play with.
***3D Printable Cases*** :
3D files provided, allowing users to print their own cases in different colors and styles.
***User Presets Community*** :
Share and download key presets with other users, making it easy to set up your keyboard your way.
***Affordable*** :
High functionality without the premium price of commercial alternatives.
# Features
8 Fully Programmable Keys
3.5 inch LCD ( 480 x 320 pixels resolution)
PC Monitoring Full Screen Mode
5 Profiles With Dedicated Navigation Switch
RGB Backlit Configurable (wired version only)
Hot-swappable for easy customization
Key Icon Customizable
Script Supported
Intuitive Configuration Software

Stream Deck Functionality ( Launching APP / Openning folder / Accessing Website / PC status Displaying / ... )
# How to use
The eezBotFun macro pad is actually a standard HID device, so it works out of the
box with most of the Windows, MacOS and Linux computers when you use it as a simple
shortcut macro pad (HID Mode).
Additionally you can use it as a control panel (Non-HID Mode) as well. But similar to stream deck,
you need to keep the configure app running in background to make some advanced features work.
The table below illustrates which features support HID Mode.

Please keep in mind you need run configure app running in the background when using (Non-HID Mode) features.
# Configure APP
Please see config-app folder for detailed infomation.
Currently only windows version is available.
# User Manual
[EezBotFun_Macropad_User_Manual.pdf](https://github.com/user-attachments/files/20768355/EezBotFun_Macropad_User_Manual.pdf)
# 3D Printing Housing
https://www.thingiverse.com/thing:7071758
# Discord
https://discord.gg/j7AJvjHQ7X
# YouTube
https://www.youtube.com/watch?v=CTTqsPymlk8
