01 / Project overview
Clawdmeter is a real desk-display project that presents Claude Code usage information on a small ESP32 screen. The original hardware list includes Waveshare AMOLED boards, and the project pairs the display with a desktop-side process over Bluetooth. Touch input switches views, while supported hardware buttons can send keyboard shortcuts.
02 / Materials & software
- Supported Waveshare ESP32-S3 or ESP32-C6 AMOLED board
- USB data cable
- compatible computer with Bluetooth
03 / Compatibility & setup notes
Board variants and operating systems use different setup paths. This is a community project; the displayed information depends on its companion process and the data available to it.
04 / Build the project
- Pick a listed board and its matching firmware target.
- Follow the instructions for your desktop operating system to flash and pair the device.
- Install or run the documented companion process, then verify the displayed usage before customizing animations.
FROM THE ORIGINAL PROJECT
The upstream usage screen shows the project’s compact information layout; values are example data.
HermannBjorgvin/Clawdmeter · View original image
05 / Check the result
Check pairing, reconnection and the last received update. Test buttons in a harmless application first so you can see which shortcut each one sends.
PineMux build note: Keep a record of the board revision, firmware version and first successful test. Follow the upstream guide for exact pins and commands.
FROM THE ORIGINAL PROJECT
The original AMOLED 1.8-inch screen variant illustrates how the layout adapts to this display.
HermannBjorgvin/Clawdmeter · View original image
06 / Sources & build notes
- HermannBjorgvin/Clawdmeter — original project, documentation and code
- Waveshare hardware reference linked by the project
Upstream attention: 2,229 GitHub stars, checked 30 September 2026. Stars indicate community interest, not a reliability guarantee.
Original project by HermannBjorgvin. This PineMux editorial overview is based on the linked primary source; PineMux has not bench-tested this build.
