https://github.com/famouswolf/deskbuddy

An ESPHome desk buddy for an ESP32 S3 Box 3 with a happiness meter that can be set using HomeAssistant
https://github.com/famouswolf/deskbuddy

desk-buddy deskbuddy esp32 esp32-s3 esp32-s3-box-3 esphome home-assistant homeassistant

Last synced: 3 months ago
JSON representation

An ESPHome desk buddy for an ESP32 S3 Box 3 with a happiness meter that can be set using HomeAssistant

• Host: GitHub
• URL: https://github.com/famouswolf/deskbuddy
• Owner: FamousWolf
• License: mit
• Created: 2026-03-02T18:39:48.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-03-08T11:44:14.000Z (4 months ago)
• Last Synced: 2026-03-08T14:50:13.881Z (4 months ago)
• Topics: desk-buddy, deskbuddy, esp32, esp32-s3, esp32-s3-box-3, esphome, home-assistant, homeassistant
• Language: C++
• Homepage:
• Size: 14.6 KB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ESPHome Desk Buddy for ESP32 S3 Box 3

An ESPHome desk buddy for an ESP32 S3 Box 3 with a happiness meter that can be set using HomeAssistant.

## States

### Neutral

When no other state is active, the desk buddy will be in a neutral state. It will show two large eyes that blink and move horizontally.

### Happy

When the happiness meter is above 50, the desk buddy will be happy. It will show two oval half circle eyes that are higher than the neutral state and blink and move horizontally.

### Sad

When the happiness meter is below -50, the desk buddy will be sad. It will show two drooping eyes that are lower than the neutral state and blink and move horizontally.

### Scared

When the desk buddy detects a loud noise, it will be scared. It will show two small round eyes that jitter randomly for a few seconds. This will decrease the happiness meter by 10 points.

### Loved

When the desk buddy's screen is touched, it will feel loved. It will show two red, heart-shaped eyes for a few seconds. This will increase the happiness meter by 10 points.

## Happiness decay

If the happiness meter hasn't changed, every 15 minutes the happiness meter will decay towards neutral by 5 percent. This means that if the happiness meter is above 0, it will decrease by 5 percent every hour until it reaches 0. If the happiness meter is below 0, it will increase by 5 percent every hour until it reaches 0.