Skip to main content

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​

  1. Long-press an empty area of your Android home screen.
  2. Tap Widgets.
  3. Find Meshtastic in the list and drag the Local Stats widget to your home screen.
  4. 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.

  • 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
DiscordXFacebookInstagramYouTubeRedditBlueskyMastodonTelegram