Yoyuよゆう
Japanese for room to spare — which is the whole point. Your Claude usage, on your desk. Let's get it running.
Pick your board
Yoyu runs on one small Waveshare dev board — no Raspberry Pi, no soldering. Two work. They flash differently, so choose first.
The Amazon link above is an affiliate link — I earn a commission on qualifying purchases.
Pick one to continue — you can change it later.
Flashing the 2″ LCD
Flash the board
Plug the board into your computer with a data USB-C cable (a charge-only cable won't work), then:
Send yourself the link and open it on a computer running Chrome or Edge. That's the only step that needs one — everything after it works from anywhere. Your board choice travels with the link.
https://daveeuson.github.io/Yoyu/
Pick the board's port when asked, then Install. Takes about a minute.
The flasher didn't load. Reload the page, and if it still doesn't appear, see the troubleshooting guide.
Board not showing up?
Hold the BOOT button, tap RESET, release BOOT, then click Connect again. If there's still no port, try a different USB-C cable — most are charge-only.
Put it on your Wi-Fi
This happens in the same window that just flashed it. When it finishes, that window offers “Connect to Wi-Fi.” Click it, pick your network, type the password once — it's sent to the board over the USB cable you already have plugged in. No hotspot, no app.
The board reboots and shows its address on screen. Write that address down — it's how you'll change settings later.
Closed that window, or it never offered Wi-Fi?
A flashed board with no network to join puts up its own Wi-Fi instead.
From a phone or a laptop, join the network named
Yoyu-Setup (password yoyusetup), open
http://192.168.4.1, and tap your home network from the
list. (That network only exists once step 2 is done — a board you
haven't flashed yet won't broadcast it.)
Feed it your usage
Run the little companion on the computer where you use Claude Code. It reads your existing login and sends usage to the board — no extra sign-in. Download it and open it; there's no installer to run:
Windows says “protected your PC”? macOS won't open it?
Expected — the companion isn't code-signed yet, so both systems warn on first launch. On Windows, click More info → Run anyway. On macOS, right-click the download and choose Open instead of double-clicking. You only do this the first time.
It finds the board on your network automatically. Within a minute or two the meters go live.
claude once on this computer to sign in
(check with claude /usage); the companion should then print
[LIVE], not [estimated].
It didn't find the board?
First, check they're on the same Wi-Fi — the board and this computer have to be on the same network, not a guest network, and not behind a VPN. That's the usual cause.
If they are and it still can't find it, the troubleshooting guide covers pointing the companion straight at the address from step 3. Otherwise just leave the companion running — it sets itself to start with your computer, so the meters stay fresh.
That's it
This is what you were aiming at. Photographed on the 2″ board — yours is the square one.
Leave it somewhere you'll glance at it. Amber under 30% left, red under 10%, and when a window runs out it puts up a countdown to the reset by itself.
If you go past your plan limits and start spending usage credits, it shows those too — the money rather than a percentage, and a phone alert the first time a period tips over. It only appears once credits are actually being spent, so most days you'll never see it.
On the board: tap to change screens, long-press to flip between “% left” and “% used,” swipe to change brightness, and lay it face down to sleep.
On this board: the screens rotate on their own — touch isn't working on the AMOLED yet, so leave auto-rotate on and use the browser for the rest.
Everything else lives in a browser, at the address the
board shows on screen: /settings for screens, theme,
character and clock, /alerts for phone notifications, and
/update to take a new version over the air.
Pick a character. Five of them, and each one shows your headroom its own way — the kitsune's tails, the moon's phase, a candle burning down, a plant growing, a cat's ball of yarn. It's on the same settings page, and you can change it as often as you like.