statsbadge
Your PC's vitals on a Badgeware Tufty 2350. A compact, wireless and extensible hardware monitor for Windows, macOS and Linux.
Runs on Badgeware's Tufty, firmware v3.0.0 and above, with a 2.8" 320x240 colour IPS display.
A server on your PC measures your local system stats, fetches and transforms data from APIs, and feeds your badge with the data it needs over WiFi. Fully customise the badge layout in a local web UI and apply your choice of theme or colour accent.
About 12 hours on battery with the backlight low, so a badge that sits on your desk ideally wants a power supply.
Install
A .dmg for macOS and an .msi for Windows, on the latest release. On Windows you'll need to choose More info and then Run anyway.
On Linux, or to have it on your PATH:
uv tool install statsbadge # or: pip install statsbadge
statsbadge tray
Setting up a badge
Plug a Tufty 2350 running firmware v3.0.0 or above in and press Update badge in the config UI, from the tray menu. That copies the app across, sets up WiFi if you tick the box, and pairs the badge with this computer.
Without a cable, press Pair a badge, then launch Stats on the badge and press B. It finds the computer by itself and shows a six-character code to check and approve.
A badge can be paired with several computers, and draws whichever one it can reach.
What it reports
| Group | Fields |
|---|---|
cpu |
load, per-core, temperature, clock, load average, processes |
mem |
used, total, percentage, swap |
gpu |
load, temperature, VRAM, power, clock, fan |
net |
up/down rate and totals, interface |
disk |
used, total, read/write rate |
power |
battery, charging, package watts |
fans |
RPM |
sys |
host, OS, CPU name, uptime |
See the Help tab for help setting up advanced local sensor readings.
Pages
Twelve ways to lay out your data:
| Page | Layout |
|---|---|
dial |
one reading as a big sweep gauge, with three smaller readouts beside it |
dials |
up to four readings as gauges side by side |
bars |
a list of readings as horizontal bars, good for per-core |
graph |
one or two readings over time |
grid |
up to six readings as big numbers |
text |
labelled lines, for names and versions |
rings |
up to four readings as concentric gauges, each coloured by its value |
spark |
six readings at once, name, current value and recent history a row each |
radar |
three to six readings as a polygon: the shape of the load rather than its size |
trend |
one big reading, which way it is going, and where it has been |
waterfall |
a list field as lanes over time, interpolated between polls |
badge |
the badge's own vitals, which need no reading from the host |
Quick add offers ready-made pages - CPU Overview, Network Graph, System Overview - with their fields already chosen.
UP and DOWN page back and forth, HOME opens the list of computers, and A, B and C run whatever you bind them to: a command on the host, or paging and brightness on the badge.
Themes
Sixteen themes, previewed in the config UI as you pick them. Four of them are built from an accent of your own, in twelve hues and four families.
Extensions
Go to the Extensions tab to see and install available extensions, adding readings and even new badge layouts.
- statsbadge-clock, five clock faces and the weather, for as many places as you have pages.
- statsbadge-quakes, recent earthquakes on a world map, from USGS.
- statsbadge-iss, the space station across the same map, with its ground track and the day and night terminator.
Mastodon, Bluesky, Cloudflare, Octopus Energy and global wildfires plugins are also installable from the config UI.
Security
Everything a badge and a computer exchange is signed against a secret they agreed at pairing. The config UI is bound to 127.0.0.1 (not available over LAN) and host commands only run if you've bound one to a button.
1 maintainer
Release files for statsbadge 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| statsbadge-3.0.0.tar.gz | 2.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| statsbadge-3.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.0 MB
Release files / statsbadge-3.0.0.tar.gz
| Download URL | statsbadge-3.0.0.tar.gz |
|---|---|
| Size | 2.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9aefccc4de164b36b90efa9f3b9986a5b66cb32d180c838fcd1c8d82225bde16
|
|
BLAKE2b-256 checksum How to use checksums |
33aaa5248c9062a974b68581894b0bc978e7b3b51a0b569067e8d0be3ce2ea3d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / statsbadge-3.0.0-py3-none-any.whl
| Download URL | statsbadge-3.0.0-py3-none-any.whl |
|---|---|
| Size | 873.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7dbdd6e350498228856b634d8c1e0ca779b6040ce344300b333c68e51256254b
|
|
BLAKE2b-256 checksum How to use checksums |
323d2d7042ca986945cc450bd48de2a988200aac021b30b2325aa819da994330
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
