Skip to main content

statsbadge-clock

A clock and the weather, for statsbadge.

Five faces. A Swiss railway station clock whose second hand sweeps at the badge's frame rate, Koppel's dotted minute track, and the badge's squircle in whatever theme it is wearing. Then two digital faces, one set in the app's typeface and one in seven-segment digits over their unlit segments.

Railway Dots Squircle Digital Digital LCD

Weather comes from Open-Meteo: the condition with a symbol for the sky, temperature, what it feels like, humidity and the wind. No key and no account.

Install

statsbadge ext add clock
statsbadge install

Then add a Clock page in the config UI.

Settings

Set a Place under Extensions - a town or city, and a country after a comma if the name is a common one:

Sheffield          the one most people mean, by how well known it is
Sheffield, US      Alabama
Paris, US          Texas

Which one you got comes back as weather.place, so the Live panel shows it. Latitude and longitude reach a spot no name lands on, and win wherever both are set. Temperature reads in celsius or fahrenheit, wind in km/h, mph, m/s or knots.

Every clock page then has settings of its own, so two pages can show two cities. A place settles the time as well as the weather, since Open-Meteo returns a location's UTC offset with its forecast: point a page at Tokyo and it shows Tokyo's time, with no timezone to set anywhere. Each page picks a face:

Face What it is
railway Hilfiker's station clock in the Mondaine colourway, keeping its own livery
dots Koppel's dotted minute track, needle hands with a spike opposite each
squircle The badge's furniture, in the page theme
digital No dial: date, place, the time the height of the band, weather under it
lcd The same layout in seven-segment digits, over their unlit segments

Without a location the clock still keeps time, and the weather readouts read "no location set".

The same settings work from the command line, for a host with no browser near it. Anything stored by the UI wins over the flag.

statsbadge serve --extension clock.place=Sheffield
statsbadge serve --extension clock.latitude=53.38 --extension clock.longitude=-1.47

Notes

The hands run off the badge's clock, set once from the host, so they keep time when the host goes away and the second hand sweeps whether or not a reading has landed. A place name is looked up once ever, not once a launch.

The seven segments are DSEG by keshikan, under the SIL Open Font License, whose text travels with the package.

Release files for statsbadge-clock 1.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for statsbadge-clock 1.2.2
File Size Uploaded
statsbadge_clock-1.2.2.tar.gz 38.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for statsbadge-clock 1.2.2
File Interpreter ABI Platform
statsbadge_clock-1.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 60.7 kB

Release files / statsbadge_clock-1.2.2.tar.gz

Download URL statsbadge_clock-1.2.2.tar.gz
Size 38.0 kB
Tags Source
SHA-256 checksum
How to use checksums
fbbb69fa4e44d6c89b8c68e6f199d8d7743d7928a38602e398a09faf5f918915
BLAKE2b-256 checksum
How to use checksums
67a6f50523fb2b6db38e917528442a9e0dfdb9165bbf055c95be3d132d924c76
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.2

Release files / statsbadge_clock-1.2.2-py3-none-any.whl

Download URL statsbadge_clock-1.2.2-py3-none-any.whl
Size 22.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fbd3abf540061f7dec091adf2dcd3c4b79b59bd82e94c04dcc543471b40964ba
BLAKE2b-256 checksum
How to use checksums
b99599203121ca3643528001dc4b34b7b86789e1cf8b857aa4f5a8049b64a149
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.2

Release history Release notifications | RSS feed

2.0.0

2 release files

1.3.0

2 release files

This release

1.2.2 This release

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page