Repository navigation
Releases
v0.6.1
Server and add-on update; the firmware is unchanged (no need to update the display).
Changed
- The example configuration is now
config-example.yaml(wasconfig.example.yaml): Home
Assistant read everyconfig.*.yamlin the repository as an add-on and logged a warning.
Existingconfig.yamlfiles are not affected.
Fixed
- Home Assistant add-on: a refused API access (HTTP 401/403) now stops at once with "refused
access" instead of being retried and reported as "not reachable". - Home Assistant add-on: a repeated name under "More secrets" is ignored with a warning (the first
one counts) instead of silently replacing the earlier value. - Home Assistant add-on:
timezone:orlang:left empty inconfig.yamlnow uses the value from
Home Assistant instead of failing.
v0.6.0
Server update with a new way to run it: the Home Assistant add-on. The firmware is unchanged
(no need to update the display). Docker users update the image as described in
docs/en/updating.md; Home Assistant OS users can install the add-on, see
docs/en/home-assistant.md.
Added
- Home Assistant add-on (
ha-addon/, repository filerepository.yaml): the server installs from
the add-on store, starts with a clock + weather playlist using Home Assistant's time zone,
language and home location, keeps secrets in the add-on form, and shows the display address and
page previews in the add-on's web UI (Ingress, behind the HA login). Ahomeassistantpage needs no
token there. In add-on mode the LAN port serves only frames, push and health. - New look for the server overview (light and dark, same style as the device page). In the
add-on it opens with a "Connect your display" card: the address to copy, three setup steps and
a live status that shows whether a display is fetching pictures.
v0.5.1
Server update; the firmware is unchanged (no need to update the display). Update the Docker
image as described in docs/en/updating.md.
Added
- ai page: option
show: remainingshows how much of a limit is left instead of used. The bar
starts full at 100 % and drains towards 0 %; the color still follows what is used, so red
always means little is left. Over-use shows0 %, a reset window100 %, copilot shows what
is left of the allowance (88 / 300). Default staysused. (#6) - Project website at https://robinlanger.github.io/glancebox/ (English) and
/de/(German):
a landing page and a guided five-step setup, built fromdocs/with MkDocs Material and
published by.github/workflows/pages.yml. It loads nothing from other hosts. - The docs parity check also compares front-matter keys between English and German.
Changed
- ai page:
claudeandanthropic-apiappear in Claude's colors, dark like claude.ai: warm
charcoal background, the title in Claude orange (serif), orange bars that turn red from 75 %
used. Colors only, no logo. The other providers and pages keep their look.
v0.5.0
Firmware update for the display; the server is unchanged (no need to update the Docker image).
Update the display over the air as described in docs/en/updating.md.
Added
- New device web page in an Apple-like look: status tiles (connection, last image, Wi-Fi in
words, uptime) that refresh every 5 s, grouped settings, light and dark mode, one column on
phones and two on wide screens. Nothing is loaded from the internet. - Brightness and night brightness are sliders: the display follows while you drag
(POST /api/brightness-preview, never saved), and the value is saved when you let go. - Every setting is saved on its own (
POST /api/settingswith any subset of the fields), with a
check mark or an error message per row; the server address offers Undo. Night mode has a
switch. The password has its own Change button. - Firmware upload in the browser computes the MD5 itself and shows a progress bar.
Security
- Device pages can no longer be framed by other sites (
X-Frame-Options: DENY,
frame-ancestors 'none'), so the auto-saving controls cannot be clickjacked. - The embedded CSS/JS are revalidated on every load (
no-cache+ETag) instead of being cached
for a year, so a script injected once over plain HTTP cannot persist.
Changed
- The safe-mode page and the message pages use the same look (still no JavaScript in safe mode).
- CSS and JavaScript live in
firmware/web/and are minified, gzipped and embedded at build time
(firmware/scripts/embed_web.py,tools/webasset.py).
Fixed
- Brightness settings now visibly dim the display. The backlight used a linear duty, so
20 % looked about half as bright as 100 % and 5 % was only slightly darker. It now follows
a quadratic curve with a finer PWM range (0 % is still off).
Smoketest: PASS on GeekMagic SmallTV Ultra, previous = v0.4.0 (2026-11-18). 24 h soak OK (2026-11-20): published .bin, uptime > 24 h, no failed boots, no safe mode, free heap stable.
v0.4.0
Added
homeassistantpage: live values of up to six Home Assistant entities (REST API with a
long-lived access token from.env) as tiles (1–4) or a list (up to 6). Numbers are rounded,
W/Wh from 1000 become kW/kWh, on/off becomes words such asopen/closedwith colours,
unavailable entities shown/a, unknown onesmissing. Own notices for no connection and a
rejected token. Texts indeanden.tools/ha-sim/: a simulated Home Assistant (Docker Compose, template entities that change
over the day) to develop and test thehomeassistantpage without a real smart home.
Notes
- The firmware code is unchanged from 0.3.0; only its version number changes. This release is
about the server and its pages.
The firmware code is unchanged since 0.2.0 (24 h soak OK on 2026-11-16 with the same code). The 0.4.0 firmware image was not smoketested on hardware; the homeassistant page was tested against a simulated Home Assistant.
OTA update 0.2.0 → 0.4.0 with the published .bin on a GeekMagic SmallTV Ultra (2026-11-16): OK, boot_failed 0 and frames arriving after the restart. The full smoketest (rollback steps) was not run.
v0.3.0
Added
- Template library: the
weather(Open-Meteo forecast),kuma(Uptime Kuma status page) and
aipages.aiselects its source withprovider::claude(5-hour and weekly limits,
pushed from a Claude Code status line),anthropic-api,openai-apiandxai-api(cost or
balance, optional budget bar) andcopilot(official GitHub billing usage, needs
monthly_allowance, unitai-creditsorpremium-requests). All pages supportdeanden. ${VAR}inconfig.yaml(whole value only, an empty variable is an error) and an optional
.envfile that Docker Compose passes to the server, so secrets stay out of the config.- Top-level
push_keyandPOST /api/v1/push/<channel>: a key-protected inbox on the home
network that pages use to receive data. It answers 404 withoutpush_key. - Shared UI macros (
ui.html) for the page templates and theglancebox.http.get_jsonhelper
with timeout andglancebox/<version>User-Agent. - Status-line scripts for Claude Code in
tools/statusline/(shell and PowerShell) that push
the rate limits to the server. - Template catalog in the docs (
docs/en/templates/,docs/de/templates/) with preview images
indocs/img/templates/; the EN/DE docs parity check now covers subfolders.
24 h soak OK (2026-11-16) on a GeekMagic SmallTV Ultra. The firmware is unchanged since 0.2.0.
v0.2.0
Added
- Night mode: on the device web page set a nightly window (for example 22:00–07:00, may span
midnight) and a night brightness from 0 to 100 %; 0 % turns the backlight off./status
reportslocal_timeandnight. - Server: every frame response carries
X-Local-Time: HH:MM:SSin the configuredtimezone;
the display uses it as its clock. Night mode needs both firmware and server 0.2.0.
Fixed
- The backlight is now fully dark while the display initialises (it was at 5 %).
v0.1.0
First release of Glance Box: a Docker server that renders pages to 240x240 JPEG frames and
firmware for the GeekMagic SmallTV Ultra (ESP8266) that shows them.
Added
- Server (multi-arch image, amd64 and arm64, runs as non-root on port 8080): playlist of pages
with per-pagedurationandrefresh, headless rendering to baseline JPEG (240x240, at most
24 576 bytes), frame endpointGET /api/v1/framewithETag/304and a clampedX-Next-In,
last-good-frame fallback (600 s) and an error frame instead of a black screen. - Built-in
bahnpage that respects the 60 s minimum refresh. - Built-in
clockpage; host port of the Docker setup configurable withGLANCEBOX_PORTin.env. - Firmware: Wi-Fi setup portal (
GlanceBox-XXXXaccess point), stream-decoded JPEG frame loop,
offline status screen after 120 s without a frame, DE/EN device web UI with/status. - OTA updates over HTTP with Basic auth and a mandatory MD5; a wrong checksum or a bad image is
rejected and the running image stays untouched. - Boot-loop protection: boot counter in RTC memory, safe mode after 3 failed boots.
- Release pipeline (firmware
.binwith.md5/.sha256, GHCR image, GitHub release) and the
on-hardware OTA smoketest (tools/ota-smoketest.sh).