↓ Skip to main content
Hyper Bridge
  1. Documentation/
  2. Troubleshooting & FAQ/

Diagnostics & System Health Monitor

How to use the Diagnostics Screen to inspect real-time service status, monitor notification events, and troubleshoot issues.

📖 Documentation Menu Tap to expand

The Diagnostics Screen in Hyper Bridge provides real-time visibility into the internal operating state of the bridge engine. It gives you instant insight into listener service connectivity, permission health, recent notification event streams, and translation statistics.

If notifications are failing to bridge, or if an island dismisses unexpectedly, the Diagnostics Screen is your primary tool for diagnosing what is happening under the hood.

Accessing Diagnostics
#

In the Hyper Bridge application, navigate to: Settings → Diagnostics (under the Support & Troubleshooting section).

1. System Health Status Card
#

At the top of the Diagnostics screen, an aggregated Health Status Card summarizes your core system permissions:

  • Notification Access: Whether Hyper Bridge is actively granted Android Notification Listener privileges.
  • Post Notifications: Permission to create status bar notifications.
  • Restricted Settings: Whether Android 13+ restricted settings have been authorized for sideloaded APKs.
  • HyperOS Focus Notifications: Whether Xiaomi’s native focus/island notification channel permission is active.
Hyper Bridge Diagnostics and Health Monitor Dashboard
Figure 1: Real-time service metrics, health status, and live event log on the Diagnostics screen.
Tapping the health card immediately navigates to the interactive System Health & Setup Guide, where you can resolve any missing permissions in one tap.

2. Live Service Metrics
#

Below the health card, a responsive grid displays real-time telemetry from the running notification engine:

MetricDescriptionExpected State
Service StatusLive connection state of NotificationReaderService.Connected (Green). If disconnected, tap Reconnect to re-bind immediately.
Selected AppsNumber of applications enabled in your Hyper Bridge Library.Matches your enabled apps count.
Floating ReviewNumber of enabled apps pending review to optionally hide duplicate native pop-up banners.0 (or tap to review in Floating Setup).
Active IslandsNumber of notification islands currently active on the device screen.0 when idle; increments dynamically when notifications arrive.
Last ClassificationDomain category assigned to the most recent notification (MESSAGING, MEDIA, CALL, PROGRESS, or STANDARD).Reflects the category of your latest received alert.
Last Call StateState machine status of active phone or VoIP calls (INCOMING_RINGING, ONGOING, MISSED).Visible during active phone calls.
Last TranslatorDisplays the name of the Custom Translator rule matched against the latest notification.Shows custom rule name if matched; otherwise Default.

3. The Watchdog & Service Reconnect
#

Xiaomi’s aggressive MIUI/HyperOS background process killer can occasionally terminate long-running notification listener services.

Hyper Bridge incorporates an internal Listener Watchdog:

  • Automatic Reconnection: Whenever you unlock your phone or launch Hyper Bridge, the watchdog verifies the listener connection and re-binds NotificationReaderService if it was dropped by the OS.
  • Manual “Reconnect Now” Button: If the Diagnostics screen reports Disconnected, tap the Reconnect icon button in the top bar. This forcibly cycles the Android notification listener component and re-establishes the connection without requiring a device reboot.

4. Live Diagnostic Events Stream
#

The bottom section of the screen presents an append-only timeline of recent internal events captured by DiagnosticsStore:

flowchart TD
    N["Incoming Notification Event"] --> D["DiagnosticsStore Record"]
    D --> E1["ℹ️ INFO: Notification received from com.whatsapp"]
    D --> E2["🔍 MATCH: Custom Translator 'WhatsApp VIP' applied"]
    D --> E3["🎨 ISLAND: HyperIsland card published (Business ID: 4821)"]
    D --> E4["⏱️ TIMEOUT: Island dismissed after 6s float duration"]

Event Levels Explained
#

  • INFO (Blue): Normal operational events, such as notification receipt, media metadata updates, playback state changes, or island creation.
  • WARN (Yellow): Non-fatal occurrences, such as an app being skipped due to missing floating notification confirmation, or an action slot index not found in the original notification.
  • ERROR (Red): Failures that prevented an island from rendering, such as an invalid custom translator regex pattern, memory allocation limits, or an OS security rejection.

5. Exporting Diagnostics for Support
#

When requesting technical support in the community or filing a bug report:

  1. Tap the Copy Diagnostics button in the Diagnostics screen header.
  2. Hyper Bridge exports an anonymized log including:
    • Device model, Android OS version, and HyperOS build.
    • Core permission flags.
    • Active island telemetry.
    • Chronological event timeline (timestamps, source packages, and status codes).
  3. Paste the diagnostic report into your GitHub issue or message.
Privacy Guarantee: Diagnostic event logs only record package names, system state codes, and operational flags. The actual text bodies and sensitive content of your notifications are never logged or exported.

Next Steps
#