Lovecat (Cute Eyes)

Lovecat is a small DIY companion device: an ESP32-driven kit with a 0.96" OLED that displays cute eye animations and reacts when you are nearby.

Preview

Features

• Multiple eye animations and expressions
• Proximity detection: switches to an "in love" animation when a configured hotspot is nearby
• Simple single-button menu and mini-games
• Heart-themed graphics (16×16 heart bitmap included)

Parts

• ESP32 development board
• SSD1306 0.96" OLED display (I2C)
• Push button
• 600 mAh LiPo battery
• TP4056 LiPo charger module

Wiring (summary)

• OLED SDA -> ESP32 SDA (e.g. GPIO 21)
• OLED SCL -> ESP32 SCL (e.g. GPIO 22)
• Button -> ESP32 GPIO 2 (use INPUT_PULLUP)
• LiPo and charger wired per module instructions (observe polarity and safety)

Controls

• Short press: advance/select in menu
• Long press: open/confirm menu (long-press in a game exits)

Build & Flash

1. Install Arduino IDE or PlatformIO and the following libraries:
   • Adafruit_GFX
   • Adafruit_SSD1306
2. Open lovecat/lovecat.ino and configure pins if necessary.
3. Select your ESP32 board and flash the sketch.

Notes & Credits

• Created as a personalized gift — feel free to tweak animations or timings.
• Heart bitmap and simple UI are included in the sketch source.

License

Under MIT License.