Installing ESPHome

If you don’t have Home Assistant and just want to use Buttfinity as a BLE keyboard, instead of step 1, follow the instructions here .

Add ESPHome to your Home Assistant by clicking this link and clicking “Install”.

Then in ESPHome Device Builder:

Click “New Device”
Click “Continue”
Enter a name for your device and enter your Wifi name and password.
Select “ESP32” or “ESP8266” as the board (depending on your microcontroller)
Click “Skip” when asked to install to your device.
A new device should appear in the list, click “Edit” and you should see the config for your device.
If you have an ESP32, change line 5-8 to:

esp32:
  board: wemos_d1_mini32
  framework:
    type: arduino

If you have an ESP8266, change line 5-6 to:

esp8266:
  board: d1_mini

Click “Install” in the top right corner and select “Manual Download”.
Wait a few minutes until it’s done compiling, then select “Factory Format (Previously Modern)” as the version you want to download.
Open ESPHome Web and click “Add Device” in the top right corner, connect your microcontroller to your computer, click “Connect”, select your device.
Click “Install” and add the project you downloaded from the ESPHome Device Builder and wait until it’s done installing.
From now on you can flash you microcontroller wirelessly in the ESPHome Device Builder, you can either add buttons to connect to Home Assistant there or use it as a BLE keyboard

Hardware