Skip to content

Modifying the Firmware

The firmware running on the Satellite1 is open source. All we ask contribute back the FutureProofHomes community by submitting pull requests to the Satellite1-ESPHome repository. You may want to modify and flash your custom firmware on the Sat1 to do the following:

  • Hardcode your Wifi SSID & Password
  • Hardcode the Snapserver's IP address
  • Add custom wake words
  • Hide or show more logs for deep troubleshooting
  • Change or extend the core functionality in any way you desire.
After taking control of your device's firmware you will no longer receive official firmware updates. If you'd like to get back in sync with the official Sat1 firmware you'll need to restore factory firmware back to the Sat1.
Please also be aware that flashing custom firmware can potentially damage the Sat1 device. These instructions are provided with the understanding that you have the necessary expertise to proceed. We will assume a certain level of familiarity with the process. Proceed with caution, and enjoy the journey!

ESPHome Compatibility Matrix

Specific Sat1 firmware releases can only be compiled with specific ESPHome versions.

Sat1 Release ESPHome Version
v0.1.3 2025.5.2 - 2025.7.5
v0.1.2 2025.5.2
v0.1.1 2025.4.2

Import the Sat1 to your ESPHome Dashboard and Take Control

NOTE: Your Home Assistant instance must have the ability to run "Add-Ons". If you cannot run add-ons, see alternate ways to run this software by reading ESPHome's official documentation.

  1. Ensure you're running the correct ESPHome Device Builder version that follows the above ESPHome compatibility matrix:
    Install ESPHome Device Builder

  2. After the install is complete click "Open Web UI":
    Open WebUI

  3. Click "SHOW" to see your Sat1 devices you have not taken control of:
    Show Devices

  4. Click "Take Control" and give the device a name:
    Take Control

    Give device a name

  5. Wait while the firmware compiles and your Sat1 is flashed over-the-air with your new firmware. This can take a significant amount of time depending on your server's hardware specs (Recommend 8gb RAM or more to avoid compilation errors). Please be patient:
    Compile Firmware

  6. When the firmware is uploaded to the Sat1, you'll see the boot logs on your screen. You can close the window and return to the ESPHome Device Builder dashboard and click the "EDIT" button and have fun!
    Edit the Firmware

Congrats. You're done!