Stock and crypto ticker
Price, change, percent change, and a sparkline for up to 8 rotating symbols. Data from Yahoo Finance with no backend, or your own webhook.
smalltv-mod
One firmware, three modes, four boards. Turn a cheap SmallTV cube into a ticker, a Claude usage meter, or a plane radar.
The GeekMagic SmallTV is a small cube with a 1.54” colour screen, an ESP inside, and a USB-C port. This firmware replaces the stock apps with three modes you switch between in a built-in web UI, and it updates over WiFi. The web UI header shows a chip badge for the board it’s running on, and an optional scheduled night mode dims or turns off the backlight on an NTP clock and timezone you pick, without taking the device offline.
The three modes
Section titled “The three modes”Claude usage meter
An animated mascot plus your 5-hour and 7-day usage bars with reset countdowns, fed over WiFi by the clawdmeter-daemon on your PC. The daemon can auto-discover several SmallTVs on the LAN and push usage to all of them at once.
Plane radar
A scope centred on your location with nearby aircraft, headings, speed vectors, and callsigns, from the free adsb.lol or adsb.fi feeds or a LAN webhook.
Plus one thing that is not a mode: on every ESP32 board the firmware carries a WireGuard client, so you can reach the device from outside your network without opening a port to the internet. The ESP32-C2 and the 8 MB SmallTV Pro have it in their only image; on the NM-TV-154, whose image is the tightest fit of the three, it comes in a second image you pick at install time.
More than the three modes
Section titled “More than the three modes”A Home Assistant screen arrives over MQTT as a JSON draw list and the device shows it as a full 240×240 screen. A notification takes the panel for a few seconds when a script pushes one over HTTP, then puts back whatever was showing. And a theme clock replaces the screen with a clock face of your own: background art, animated sprites, clock and date text, and live values from JSON sources, installed as a .stheme package with no firmware rebuild.
Design a clock face in SmallTV Studio
Section titled “Design a clock face in SmallTV Studio”SmallTV Studio is the visual editor for theme clocks. It runs in the browser with nothing to install. Stack layers on a 240×240 canvas, preview the clock at any simulated time, bind fields to JSON data, then export a .stheme package or send it to the device over WiFi.
Open SmallTV Studio The editor, hosted on GitHub Pages. Runs entirely in your browser.
Theme clocks guide The .stheme format, installing packages, and the command-line tools.
Four hardware variants
Section titled “Four hardware variants”This firmware builds for four boards from one codebase. Confirm which one you have before you flash it.
SmallTV (ESP8266) ESP-12F. Flashes over the air from the stock web UI.
SmallTV (ESP32-C2 / ESP8684) CH340C next to the USB-C port. Flashes over USB-C with esptool.
NM-TV-154 (classic ESP32) NMMiner BTC lottery miner, same cube and screen. Flashes over USB with esptool.
SmallTV Pro (classic ESP32, 8 MB) GeekMagic's higher-end model with a touch button. Flashes over the air from the stock web UI (USB-C is power only).
Start here
Section titled “Start here”Received one as a gift?
Section titled “Received one as a gift?”The user manual skips the technical background and walks through plugging it in, joining WiFi, and everyday use in plain language, no prior knowledge assumed.