ESPHome firmware for Rituals Perfume Genie devices, supporting both Genie 2 (ESP8266) and Genie 3 (ESP32-C6) versions.

• 🌊 PWM-controlled fan speed with auto-off timer
• 💡 RGB status LED (WS2812 on Genie 2, Common-Anode on Genie 3)
• 🔘 Physical button control
• 🏠 Native Home Assistant integration
• 📡 OTA updates (wireless firmware updates)
• 🔄 Automatic firmware updates from GitHub releases
• 📶 WiFi provisioning via captive portal (Genie 2) or Bluetooth (Genie 3)

Visit https://pvizeli.github.io/esphome-genie/ for:

• 🌐 Web-based firmware installer - Flash your device directly from the browser
• 📖 Hardware flashing guide - First-time setup instructions
• ⚙️ Configuration guide - WiFi setup and Home Assistant integration

• genie-2.yml - ESP8266 (Genie 2) configuration
• genie-3.yml - ESP32-C6 (Genie 3) configuration
• common.yml - Shared configuration for both devices

# Validate configuration
esphome config genie-2.yml
esphome config genie-3.yml

# Compile firmware
esphome compile genie-2.yml
esphome compile genie-3.yml

1. Create a new release on GitHub with a version tag (e.g., v1.0.0)
2. GitHub Actions will automatically:
   • Build firmware for both devices
   • Create a combined manifest file
   • Upload binaries to the release
   • Deploy to GitHub Pages

.
├── genie-2.yml              # ESP8266 device config
├── genie-3.yml              # ESP32-C6 device config
├── common.yml               # Shared configuration
├── static/
│   ├── index.md            # Main documentation page
│   ├── flashing.md         # Hardware flashing guide
│   └── _config.yml         # Jekyll configuration
└── .github/workflows/
    ├── ci.yml              # CI testing (stable/beta/dev)
    ├── publish-firmware.yml # Release builds
    └── publish-pages.yml   # GitHub Pages deployment

• GPIO3: Power button
• GPIO4: Fan PWM control
• GPIO15: WS2812 LED
• GPIO0: Flash mode (boot mode)

• GPIO17: Power button
• GPIO4: Fan PWM control
• GPIO23: RGB LED (Red)
• GPIO22: RGB LED (Green)
• GPIO3: RGB LED (Blue)
• GPIO9: Flash mode (boot mode)

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

• Official Documentation
• ESPHome Documentation
• Home Assistant Community Discussion

See LICENSE file for details.

Based on community efforts to reverse-engineer and provide open-source firmware for Rituals Perfume Genie devices.

Special thanks to:

• KarolKozlowski/esp-geine for hardware documentation
• Home Assistant community for testing and feedback