Web-Based GUI

The user interface for critterOS is a web page served by the ESP8266, providing a rich and interactive experience. Key features include:
   • Panel Creation: Users can create panels and define the type of software interface attached to each panel. Panels are saved in memory for persistent configuration.
   • Data Logging: A logger interface allows users to log sensor data into a file, which can be uploaded to a database and charted for analysis.
   • Interpreter: write automation as IF/THEN rules over any panel or variable (for example IF temperature > 25 THEN heater = 0), grouped into programs that can also run ordered SET and WAIT steps. Rules fire once on a rising edge or continuously while true. This enables users to automate actions based on sensor data.
 • Calibration and Averaging: Each created panel has controls for sensor calibration and the ability to average multiple values.
   • OLED Display: The 128x64 OLED display can show values from different panels, with user-configurable display options.
critterOS is designed to be a versatile and powerful tool for anyone looking to integrate and control various sensors and actuators with ease. Its combination of hardware flexibility and a robust software interface makes it suitable for a wide range of applications.

On top of that, the dashboard provides MQTT integration with Home Assistant auto-discovery, user-defined and computed variables, automation programs with IF/THEN rules, WAIT/SET statements and full backup and restore of your configuration. ESP32 users: see the ESP32 page for direct cloud (ThingSpeak + Telegram) and flashing instructions. Need cloud IoT on ESP8266 or a centralised setup? See critter-bridge.

Try it on any ESP8266 or ESP32 board

You don't need Firefly hardware to explore critterOS — it runs on any ESP8266 board with 4 MB flash (Wemos D1 Mini, NodeMCU and equivalents) and on ESP32 (D1-mini-footprint boards, e.g. node32s). Just go to the critterOS Uploader page in Chrome or Edge, plug the board in over USB, click Connect, and choose Flash firmware + filesystem for ESP8266 or the ESP32 button for a full ESP32 flash — the firmware files are already bundled into the page, nothing to download. Already on 2.0-f446560 or newer? Grab firmware.bin from the downloads page and flash it from the dashboard's Update page — no USB needed. Prefer flashing offline with Python? Grab the ESP8266 USB bundle or ESP32 USB bundle with the flasher included (install esptool once with pip install esptool). The board will open a WiFi network called firefly: join it, open http://192.168.4.1, and enter your WiFi credentials in Settings. On your home network, skip IP hunting entirely with the fixed name http://firefly.local. Then create panels and experiment — see Documentation for the guides.

Updating from 2.0-5c18013 or older? Those builds used the Tasmota ESP8266 core. Updating one of those boards to this build requires a one-time full USB flash with chip erase: use the Uploader's Flash firmware + filesystem button, which erases the chip. Flashing firmware only, or using the dashboard OTA updater, can boot-loop on rf cal sector: 1020. After that one-time migration, OTA updates work normally.