/sonoff-homekit-flasher

Easily turn your Sonoff/ESP-based chipset into a HomeKit switch with all the hassle

Primary LanguageTypeScript

Sonoff HomeKit Flasher

Easily flash Sonoff devices with Sonoff-Homekit firmware using esptool with a GUI.

Screenshot of Sonoff Homekit Flasher

Built with Tauri and SolidJS

Installation

Go to Releases and download the latest release

This is an unsigned build, you might have to run the following command upon first launch on macOS:

# App Path should be "/Applications/Sonoff Homekit Flasher.app", include the quotes for proper escaping
sudo xattr -r -d com.apple.quarantine [APP PATH]

On Windows, you might have to click More Info > Run Anyway on the SmartScreen warning to proceed with the installation

Usage

On Windows, you might have to install drivers from FTDI for the USB to Serial adapter to work


On macOS, it should recognise the adapter out of the box

Build

Make sure you have Bun and Rust installed

Install dependencies

bun install

Build your own esptool

Building esptool is only supported on macOS at the moment, output binaries will be put into place automatically by the script

bun build:esptool

Make sure you a wine-crossover, universal Python version, pyinstaller, intelhex and pyserial installed

Build the app

Building for macOS

bun build:macos

Building for Windows

bun build:windows

Building for Windows on Windows is not tested. To compile on macOS, make sure you have cargo-xwin installed