EspDeck

This is a StreamDeck inspired macro pad powered by EspHome for use with Home Assistant. Each key has 3 different actions it can perform, single click, double click, and click + hold. These can all be tied to different automations in Home Assistant. This project is made for ESPHome (hardware + ESPHome Configuration).

Functionality

ESPDeck provides a macropad type input set to Home Assistant based on ESPHome. This includes 3 modes of input for each keyswitch.

• Single Click
• Double Click
• Click and Hold

Variants

There are a number of variants of the device in this repository. The standard EspDeck is a 9 key pad. There is also the novelkey macropad, which has two BIG switches, and an upcoming design to add NFC functionality to the EspDeck macropad (NfcDeck). All of these use the same basic features in ESPHome and previous iterations of the designs are maintained for legacy support. Do look at the variant specific README files for the hardware needed, 3d print files, and yaml configurations.

EspDeck

There are also previous generation EspDecks (Gen 1, Gen 2) in this repository.

NfcDeck

Additional Functionality

• NFC Card Reader
• Rotary Encoder
• Per Key Addressable Backlighting

Novelkey Novelty macropad

Additional Functionality

• Per Key LED Backlighting
• BIG switches

Hardware Used

• 1 x ESP8266 / NodeMCU
• 9 x Relegendable KeyCaps (waterslide decal paper can also be used with existing keycaps, especially blank ones)
• 9 x Mechanical key switches
• Hot Glue
• 3d printer material
• various wire

STL Files for 3D Printing

All the case designs can be found on Github, Printables, and Thingiverse

Configuration

EspHome YAML files are included with each project and are versioned to allow for legacy device support.

Printing Instructions

These can be printed with low infill for speed and with a medium to thick layer height, they don't need a fine layer height to print well. All the designs are intended to be printed without supports (except the main enclosure for the novelkey novelty macropad).

Contributing

Contributions are welcome to the project

Change Log

• With generation 2, we simplified the design, reducing the number of resistors needed in the wiring.
• With generation 3, we begin to use the Matrix Keypad feature of EspHome, simplifying the wiring.

To Do:

• Update the case designs to use heat set inserts to make them more maintainable rather than hot gluing the top down, also more professional
• Add WS2812 LEDs to backlight the key switches, providing an aveneue for notifying of a status from home assistant on the OG ESP Deck Designs
• Create a 3 key NFC deck variant with 2 key switches and a rotary (or keyswitch for the third)

Star History

(you guys rock)