mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-06-26 22:45:30 -04:00
8346b18cc4
Audit the user docs for accuracy against the code, enrich them with
component-level screenshots, and separate the doc-screenshot generation
path from the visual-regression gate so doc framing no longer churns test
baselines.
Veracity fixes (claims verified against code):
- connections: removed 3 screenshots that were from the unrelated mPWRD/nymea
WiFi-provisioning app and rewrote the TCP/IP section to match the real
Network transport flow (mDNS scan + manual IP:4403); replaced the BLE
"scan" image (it was the wifi-provision splash) with the real device list.
- nodes: online window is 2h (not 15min); binary online/offline, no "away" tier.
- map: markers are identity-colored node chips, not online-status colors.
- node-metrics & signal-meter: signal quality is preset-relative SNR, not
fixed thresholds.
- messages: max message length is 200 bytes (not 237/230).
- telemetry: CO2 bands aligned to Co2Severity (Good/Stuffy/Poor/Unsafe/Evacuate).
- translate: locale dirs use {lang}-r{REGION}.
New pages: Home Screen Widget, Help & In-App Docs (Chirpy on-device AI).
Screenshot enrichment + tighter framing: added IAQ scale, firmware verifying,
TAK local server, quick-chat dialog; cropped firmware states and connections
panes to component-level views instead of full-screen frames.
Pipeline split (new :docs-screenshots module, generate-only, not CI-gated):
holds doc-framed compositions so reframing a doc image never moves a regression
baseline; :screenshot-tests stays the gate. copyDocsScreenshots aggregates
both modules. Updated CI filter, governance advisories, dev docs, and the
testing-ci skill.
Translated docs re-sync from the English source via the scheduled Crowdin job.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.8 KiB
1.8 KiB
title, parent, nav_order, last_updated, description, aliases
| title | parent | nav_order | last_updated | description | aliases | |||
|---|---|---|---|---|---|---|---|---|
| Home Screen Widget | User Guide | 20 | 2026-06-25 | Add the Meshtastic home screen widget to glance at your connected radio's local stats without opening the app. |
|
Home Screen Widget
On Android, Meshtastic provides a home screen widget that shows live local statistics from your connected radio at a glance — no need to open the app.
What It Shows
The widget displays the connected radio's current local stats:
- Battery — the radio's battery level, or Powered when running on external power
- ChUtil — channel utilization (how busy the LoRa channel is, as a percentage)
- AirUtil — airtime utilization (how much of the duty cycle your radio is transmitting)
- Traffic — packets transmitted / received, and duplicates seen
- Relays — packets relayed and relay cancellations (shown when the radio is relaying)
Tap the widget to open the app, or use its refresh control to request fresh stats.
💡 Tip: The values reflect the radio you are currently connected to. If the app isn't connected to a radio, the widget shows the last known stats until it reconnects.
Adding the Widget
- Long-press an empty area of your Android home screen.
- Tap Widgets.
- Find Meshtastic in the list and drag the Local Stats widget to your home screen.
- Resize it as needed — the layout adapts to the available space.
⚠️ Note: The widget is Android-only. It is not available on the Desktop or iOS builds.
Related Topics
- Node Metrics — the full Signal Quality and Local Stats history inside the app
- Connections — connect to a radio so the widget has stats to show
- Discovery — channel and airtime utilization across the mesh