How hermannbjorgvin/clawdmeter works
Clawdmeter pairs an ESP32 usage dashboard with a host daemon: the daemon reads Claude credentials, polls usage, and sends updates over BLE; firmware renders usage and animations on the device. Windows adds a system-tray interface and login autostart. The firmware supports multiple Waveshare boards through a shared HAL. Several firmware subsystems are represented at their documented directory or module level because their implementation excerpts were not provided; uncertain connections are omitted or dashed.
Main entry points: main.cpp Firmware Loop · claude_usage_daemon_windows.py Windows Daemon · claude_usage_daemon.py Host Daemon · tray_windows.py Tray App
Components 20
Host Monitoring
- Host Daemon
daemon/claude_usage_daemon.py - Windows Daemon
daemon/claude_usage_daemon_windows.py
Windows Tray
- Tray App
daemon/tray_windows.py - Tray Status
daemon/tray_windows.py - Status Icons
daemon/icon_assets.py - Login Autostart
daemon/autostart_windows.py
Device Experience
- Firmware Loop
firmware/src/main.cpp - Usage Payload
firmware/src/data.h - Usage Rate
firmware/src/usage_rate.cpp - Usage UI
firmware/src/ui.cpp - Animated Splash
firmware/src/splash.cpp - Idle Brightness
firmware/src/idle.cpp - Brightness Control
firmware/src/brightness.cpp - BLE Transport
firmware/src/ble.h
Board Hardware
- Hardware HAL
firmware/src/hal - Board Ports
firmware/src/boards
Other components
- Device Owner
- Claude Credentials
- Claude Usage API
- BLE Dashboard
Connections 21
- Device Owner → Claude Credentials: provides
- Host Daemon → Claude Credentials: reads
- Windows Daemon → Claude Credentials: reads
- Host Daemon → Claude Usage API: polls usage
- Windows Daemon → Claude Usage API: polls usage
daemon/claude_usage_daemon_windows.py - Host Daemon → BLE Dashboard: sends updates
- Windows Daemon → BLE Dashboard: sends updates
- Windows Daemon → Tray Status: updates status
daemon/tray_windows.py - Tray App → Windows Daemon: runs loop
daemon/tray_windows.py - Tray App → Status Icons: builds icons
daemon/tray_windows.py - Tray App → Login Autostart: manages startup
daemon/tray_windows.py - BLE Dashboard → Firmware Loop: delivers payload
- Firmware Loop → Usage Payload: parses payload
firmware/src/main.cpp - Firmware Loop → Usage UI: updates display
firmware/src/main.cpp - Firmware Loop → BLE Transport: initializes BLE
firmware/src/main.cpp - Firmware Loop → Usage Rate: tracks rate
- Firmware Loop → Animated Splash: drives animations
- Firmware Loop → Idle Brightness: initializes idle
firmware/src/main.cpp - Idle Brightness → Brightness Control: uses setting
- Firmware Loop → Hardware HAL: uses interfaces
firmware/src/main.cpp - Board Ports → Hardware HAL: implements interfaces
firmware/src/boards/waveshare_amoled_216_c6/display.cpp