BLE MACROPAD / ESP32 APPLICATION
Timewo Macropad
ESP32 BLE macropad: one firmware for many boards (C3/S3/ESP32), Windows app to configure keys, rename, remap GPIO and flash firmware

About this project
About this project
One BLE macropad firmware serves several ESP32 variants, and the Bluetooth name, button count, GPIO numbers and press timing are settings kept in NVS rather than compiled in. Envs cover ESP32-C3, ESP32-S3 and plain ESP32, up to four buttons wired from GPIO to GND with internal pull-ups, no external resistors. The finished Ti Clicker is an ESP32-C3 Super Mini in a 3D-printed shell with three keys used as a slide remote. A PySide6 desktop app on Windows pairs over USB serial or BLE GATT, writes the profile to flash and can flash firmware itself after checking SHA-256. Macros fall in two groups: shortcuts the board types on its own through Bluetooth HID, and actions such as opening apps or pasting text that need the app running. A plain ESP32-S2 is rejected — no Bluetooth.
From the README
From the README
- Input
- Tối đa 4 nút. Nút được nối giữa GPIO và GND (pull-up nội, LOW = nhấn).
- Build
- firmware PlatformIO (Arduino) cho ESP32-C3, ESP32-S3, ESP32
- App
- desktop/: ứng dụng PySide6 cấu hình profile, cấu hình thiết bị, nạp firmware,
- Limit
- ESP32-S2 không có Bluetooth nên không thể làm bàn phím BLE; app nhận diện và báo rõ.
Hardware
Boards: ESP32
Supported hardware: ESP32. Confirm the exact board revision and pin map in the upstream repository.
What the source supports
Upstream evidence: Reviewed from public README media at commit 306ba81c7b55 under MIT. Firmware was not executed.
Media credit & rights
Upstream project media · rights remain with its owner · Credit: ti014
Screenshots decoded from the upstream README at a pinned commit. Repository code and firmware were not executed; the license texts are included in the preview package.
View original source ↗ Copyright & removal · Reviewed
More projects on these boards
AIDlink Acid Box Acidportal AgentScreen Arduino Tesla Seat Async Esp Fs Webserver
See what an ESP32 project looks like, and whether it runs on your board.
FILTERS
Browse by form factor. Check the exact board, chip and peripherals before installing.
Try a project
Newest listings
Give your project a little spotlight.
Repository links do not imply author endorsement or verified hardware compatibility. Check the upstream safety guidance before powering or flashing a build.