mirror of https://github.com/ChuckBuilds/LEDMatrix.git synced 2026-10-13 10:36:35 +00:00

Files

T

ChuckandClaude Opus 5 1eed7ff485 feat(web): weekly automatic updates with health check and rollback

A General-tab toggle (off by default) checks for and installs LEDMatrix and
plugin updates once a week, overnight in the configured timezone.

- Pre-update checks skip (and report) instead of forcing: local edits or
  commits, merge/live rebase, no upstream, low disk, missing health check, or
  a version that was already rolled back. An abandoned rebase (HEAD back on a
  branch) is cleared, since it would otherwise block every pull.
- The pull reuses the Update Code path (now perform_core_update(), which
  reports dependency install failures as data).
- ledmatrix-update-verify.service, started via a .path unit from a request
  file, restarts the services from its own cgroup, requires them to come up
  and stay up, and otherwise resets to the previous commit and reinstalls the
  previous requirements. It runs a copy of the checker taken before the pull.
- No SSH needed: switching the toggle on restarts the display service, which
  (as root) installs the two units from the repo templates for the web user.
  first_time_install.sh installs them too and takes --enable-auto-update /
  LEDMATRIX_AUTO_UPDATE (passed through by one-shot-install.sh).
- Plugins update after the code passes its check; failures, blocks and
  rollbacks raise an Overview banner and show under the toggle.

Tested end to end on a Pi: web-UI setup, a good update, a broken web service
and a broken display (both rolled back), a blocked local edit, and an
abandoned rebase found on the device.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-14 17:37:35 -04:00

apply_dns_single_request.sh

test: fix the emulator port collision behind the intermittent suite failures (#562 )

2026-09-11 15:45:13 -04:00

auto_update_verify.py

feat(web): weekly automatic updates with health check and rollback

2026-09-14 17:37:35 -04:00

cleanup_venv.sh

test: fix the emulator port collision behind the intermittent suite failures (#562 )

2026-09-11 15:45:13 -04:00

clear_cache.py

Codebase audit: fix shipping bugs, remove verified-dead code, repair doc drift, add regression guards (#438 )

2026-08-06 14:04:23 -04:00

clear_python_cache.sh

test: fix the emulator port collision behind the intermittent suite failures (#562 )

2026-09-11 15:45:13 -04:00

pixlet_config_editor.sh

feat(tools): MQTT bridge and Pixlet editor, ported onto the api_v3 split (#554 )

2026-09-11 11:32:12 -04:00

README.md

feat(starlark,on-demand): the third-party fixes worth taking, plus a Home Assistant MQTT bridge (#538 )

2026-09-08 08:34:52 -04:00

start_web_conditionally.py

fix(web): default web_display_autostart to true, as the installer already does (#556 )

2026-09-10 17:42:00 -04:00

wifi_monitor_daemon.py

perf(wifi): one status fetch per monitor tick instead of three (#411 )

2026-07-14 11:22:37 -04:00

README.md

Utility Scripts

This directory contains utility scripts for maintenance and system operations.

Scripts

clear_cache.py - Clears LEDMatrix cache data (specific keys or all cache)
start_web_conditionally.py - Conditionally starts the web interface based on config settings
wifi_monitor_daemon.py - Background daemon that monitors WiFi/Ethernet connection and manages access point mode
cleanup_venv.sh - Cleans up Python virtual environment files
clear_python_cache.sh - Clears Python cache files (pycache, *.pyc, etc.)
pixlet_config_editor.sh - Opens Pixlet's own config UI for one installed Starlark app
apply_dns_single_request.sh - Adds options single-request to the resolver (run by ledmatrix-dns-fix.service)

Usage

Clear Cache

python3 scripts/utils/clear_cache.py --list          # List cache keys
python3 scripts/utils/clear_cache.py --clear-all      # Clear all cache
python3 scripts/utils/clear_cache.py --clear <key>    # Clear specific key

Start Web Interface Conditionally

This script is typically called by the systemd service (ledmatrix-web.service) and checks the web_display_autostart setting in config/config.json before starting the web interface.

WiFi Monitor Daemon

This daemon is typically run as a systemd service (ledmatrix-wifi-monitor.service) and automatically manages WiFi access point mode based on network connectivity.

Pixlet Config Editor

Run it when you want Pixlet's own config form for a Starlark app -- live render preview, cascading dropdowns -- rather than the LEDMatrix one.

./scripts/utils/pixlet_config_editor.sh                 # list installed apps
./scripts/utils/pixlet_config_editor.sh penndot_signs   # edit, on localhost:8080

Deliberately not a service. It stops the display for the length of the session and pixlet serve listens with no authentication, so it should only be running while you are actually editing. It backs the config up first and restarts the display on exit, however it exits.

It binds loopback only, with no flag to change that: anything that can reach pixlet serve can rewrite the app's config, and a printed warning is not access control. To edit from another machine, forward the port -- SSH does the authenticating and nothing is left listening on the LAN:

ssh -L 8080:localhost:8080 pi@ledpi.local

Apply DNS Single-Request Fix

Installed and run by ledmatrix-dns-fix.service; see systemd/README.md. Safe to run by hand (sudo ./scripts/utils/apply_dns_single_request.sh) and idempotent.