Buttfinity

Print profile here all models can also be found in the stls/ folder.

Modular, customizable buttons (and other controls) in a gridfinity layout, allowing you to:

• control your computer (as a "fake" keyboard, either as a BLE keyboard using a ESP32 or as HID usb device using a RP2040 (no tutorial yet for that))
• control your smart home (using a ESP8266 or ESP32)
• use as a MIDI controller (using a RP2040, no tutorial yet for that either)
• anything else you can think of

[!IMPORTANT] Work in progress. Don't expect everything to work perfectly yet.

[!NOTE] No programming necessary, some soldering is required.

How to use

[!NOTE] This documentation is for the ESP32 or ESP8266 version only, there is no tutorial for the RP2040 version yet.

1. Get the parts if you don't have them yet, see Hardware Guide
2. 3D print the bins and lids, see 3D Printing
3. Install ESPHome, see ESPHome Guide
4. Either:
   • turn your Buttfinity into a BLE keyboard, see Using as BLE Keyboard
   • or add buttons to your Home Assistant, see Add Buttons to Home Assistant

Credits

• Gridfinity by Zack Freedman
• Anylid by rngcntr for the clickable lids
• gridfinity-rebuilt-openscad by kennetek for the baseplates and bins in openscad
• Cherry MX switch by neon_c
• BOSL2 library

Built with:

• OpenSCAD
• Home Assistant
• ESPHome
• esphome-blekeyboard

License

Everything in this repository (excluding everything from the credits section) is licensed under the CC BY-NC-SA 4.0 license.