Skip to content

Updates

Yash Mulgaonkar edited this page Aug 22, 2026 · 8 revisions

Updates

From the web portal (recommended)

If the Pi was installed from a git clone, open Updates in the web portal:

Control What it does
Check Updates Compare installed version to GitHub main
Update Now git pull, refresh Python deps / assets, restart (or reboot if X11 switch is pending)
Later tonight Arm install for the night window after ~5 minutes of panel idle
Auto-install during off-hours When an update is available, install in the Off-Hours window (or 22:00–06:00 if Off-Hours is unset), after 5 minutes idle. Dismissing the radar update bubble skips that version. LiveATC playback delays the install
Finish install Completes deferred installer steps when an OTA pulled a newer install-pi.sh but did not finish (also auto-runs after reboot when needed)
Repair & Update Unblocks a mode-dirty / detached-HEAD / corrupt git tree, then updates

On phones, confirm with the in-page Install & Restart row (native browser confirm() dialogs are unreliable on mobile).

Portal Updates card

Settings and API keys under /var/lib/flightscnr/ are preserved on a normal update.

After Update Now

  • One Update Now is usually enough. If an OTA pulled a newer installer but could not run it yet, the device auto-finishes install steps after restart — or use Finish install.
  • If LightDM is switched to X11 for pinch-zoom, the Pi reboots automatically.
  • An on-device update-in-progress overlay shows while the worker runs. Stale “running” state is cleared if no worker is alive after reboot.

Stuck on an old build (e.g. 2026.8.5.x)

Older installs could leave scripts/release.sh mode-dirty, which used to block git pull. That path is now frozen upstream, so Update Now once more often works with no terminal.

If the portal shows Repair & Update, use it. If that button is missing and the pull still fails, on the Pi:

curl -fsSL https://raw.githubusercontent.com/yashmulgaonkar/FlightScnr_Pi/main/scripts/repair-ota.sh | bash

Use | bash -s -- --hard only if other local edits also block the pull. See Troubleshooting.

Notes

  • A normal git checkout under ~/FlightScnr_Pi (or wherever you cloned) is required for portal updates to work.
  • Portal preferences live under /var/lib/flightscnr/ and are not wiped by updates.
  • Facing direction, ATC prefs, favorites, HUD dark mode, and other on-device settings in round_touch_settings.json also survive updates.
  • Before a major change you can System → Download settings for a backup (includes API keys - keep private).
  • Detached HEAD (for example after checking out a release tag) is reattached to main from origin/main by Update / Repair so --ff-only can succeed.

Recent firmware (for wiki sync)

Version Highlights
2026.8.21.2 Follow live pin updates; faster Follow poll while the screen is open
2026.8.21.1 Expanded basemap styles (incl. Dark Flat); long-haul Track map framing; FR24 / ADS-B dedupe improvements
2026.8.20.1 OTA Later tonight and optional auto-install during off-hours
2026.8.19.1 Left-swipe favorite-location cycle on the radar
2026.8.18.1 ATC-style scrollable list pickers for multi-option settings; kiosk X11 cursor / Motif fixes for touch-as-mouse
2026.8.15.1 Tag leaders stay tied to traffic labels; military volume % label; clear stale update-in-progress after killed OTA
2026.8.14.1 Detail-screen finger scroll + scrollbar; CAL FIRE admin wrap; quakes drop after ~36 h; prefer FR24 type; V10 / S2T icons
2026.8.13.1 Disable Wi‑Fi power save on kiosk devices; keep last weather reading when a forced fetch still 429s
2026.8.12.2 Portal UI for route-enrichment source order; non-standard orientation blip fix
2026.8.12.x Hardened OTA (detached HEAD, hung GUI/git/pip, vfat boot writes); USGS earthquake overlay + optional voice
2026.8.11.x–8.10.x Finish install / repair-ota paths; X11 for pinch-zoom; gpio-fan overlay; position sources; Master Caution wipe
2026.8.5.4 Hardened Wayland Bluetooth popup suppression; installer no longer aborts on unwritable legacy panel configs
2026.8.5.3 Versioned Don't show again disclaimer countdown with portal clear-only reset; additional prop icon mappings
2026.8.5.2 Radar presentation capped near 30 fps; root-run audio via desktop pipewire-pulse
2026.8.5.1 Boot safety gate; Settings beside About; tracked / military sounds; update notices; Open-Meteo AQI HUD; volume controls
2026.8.3.5 Manual weather refresh bypasses local cache/rate gates while keeping last good reading on provider errors
2026.8.3.4 ATC stops cleanly when disabled or when airport/channel changes
2026.8.3.3 Track great-circle route map + aircraft photo; HUD dark mode; radar traffic freeze fix

The display checks for updates roughly every eight hours. A newer release is shown on splash and About, plus a dismissible radar bubble (re-shown after reboot until that version is installed or dismissed). Installation still happens from the portal (or Later tonight / off-hours auto-install).

Stuck “Update in progress…”

See Troubleshooting.

Clone this wiki locally