↓ Skip to main content
Hyper Bridge

Changelog

📖 Table of Contents Tap to expand

Follow the latest updates, features, and release history for HyperBridge.

HyperBridge v0.6.0-beta3 🚀
#

Welcome to v0.6.0-beta3! This release introduces the all-new Design Hub with a Bento Grid layout, a visual Island Template Composer supporting all 10 official Xiaomi HyperOS island layouts, critical fixes for Xiaomi HyperOS 4 Beta compatibility, and a streamlined documentation section.

🎨 Visual Island Template Composer & New Design Hub
#

  • Redesigned Design Screen: A modern Bento Grid interface that puts Themes, Island Widgets, Custom Designs, and Smart Translators at your fingertips.
  • 10 Official HyperOS Island Templates: Compose rich Dynamic Island layouts directly within the app using official templates—ranging from delivery tracking, boarding passes, progress transfers, and call cards to media capsules.
  • Visual Design Manager: Easily filter, inspect, preview, and toggle active custom designs per app or system-wide.
  • 📖 Learn more in the docs:

⚠️ Note on the Featured Section:
The Featured section on the Design screen is currently a work in progress (preview placeholders). In the stable HyperBridge 0.6.0 final release, this carousel will directly connect to the official website and community hub, allowing users to discover, browse, download, and install community themes, custom designs, and smart translators with a single tap.

🚀 Streamlined Guides & Direct Documentation Access
#

  • In-app help sheets and guide links have been consolidated into clean, direct section cards pointing straight to official, up-to-date online guides:
    • 🎨 Customization: Themes, templates, custom translators, and island widgets.
    • ⚡ Features: System apps integration (Timer, Recorder, Screen Recording), Smart Actions, Inline Reply, and Permanent Island.
    • 🛠️ Advanced: Shizuku override, troubleshooting, diagnostics, and power-user configurations.
    • 🧩 Custom Translators Specification: Build regex and condition-based interceptors for any notification.

🛠️ Fixes & Improvements
#

  • HyperOS 4 Beta Compatibility: Fixed an issue where standard and messaging notification islands were skipped by the system on HyperOS 4 Beta by ensuring the dismissible island parameter is explicitly set to false.
  • Direct App Launching from Messaging Islands: Tapping on message island capsules now opens the target application reliably via a direct activity intent rather than an intermediate broadcast trampoline.
  • String Quota & Performance Optimization: Massive reduction and deduplication of app string resources to keep Crowdin hosted translations within limits, while keeping guides richer and always current on the website.

What’s Changed
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.6.0-beta2...v0.6.0-beta3

HyperBridge v0.6.0-beta1 🚀
#

Welcome to HyperBridge v0.6.0-beta1! This milestone release marks the arrival of the all-new Custom Translators Framework (.htrans), powerful RAW_PARAM_V2 presentation modes, built-in Visual Translator Editor, System Update Islands, and key stability fixes for Android 15 & 16.

⚠️ Beta Notice: Custom Translators & Full Engine Rework
#

This release includes a complete architectural rework of our translation engine and the very first public implementation of the Custom Translators system.

Because this is a major transition:

  • Some advanced features, custom edge-case layouts, or specific token interpolations may still behave unexpectedly or contain bugs.
  • Certain legacy behaviors or templates may require minor adjustments.

We need your feedback! If you encounter any bugs, crashes, broken presentations, or missing features, please let us know by opening a GitHub Issue or posting in our Discussions. Your reports directly help us stabilize the engine for the final 0.6.0 release.

🌟 Highlights & Major Features
#

🧩 Custom Translators Framework (.htrans)
#

Take total control over how any app’s notifications render on Xiaomi HyperOS Super Island. Define custom matching rules, regex extractions, variable tokens, dynamic actions, and theme bindings without waiting for app updates.

  • Import, Export & Share: Seamlessly package .htrans or .htrans.zip packages with embedded artwork and share them across devices via Storage Access Framework (SAF).
  • Built-in Visual Editor: Build and test translators directly inside the HyperBridge app.

📖 Learn more in our documentation:

⚡ Advanced Custom Translations: RAW_PARAM_V2 Mode
#

For advanced creators, the new RAW_PARAM_V2 presentation mode lets you bypass standard layout constraints and write pure HyperOS Super Island JSON contracts with dynamic token interpolation ({notif.title}, {media.artist}, {var.custom}, {pic.key}).

  • Dynamic Elements: Full support for coverInfo, progressInfo, chatInfo, baseInfo, and bgInfo (color & picture background).
  • Dual Island Layouts: Full custom configurations for both smallIslandArea and bigIslandArea (imageTextInfoLeft / imageTextInfoRight).
  • Dynamic Variables & Actions: Extract progress percentages, live timestamps (startText/endText), and map custom intents or smart actions on the fly.

🔗 Official Xiaomi Specifications & Guides:

🔄 System Update Island Integration
#

HyperBridge now brings a native-like experience to Xiaomi System Updates:

  • Track download and install progress directly on the Super Island.
  • Dedicated customization and timeout settings within the app.

🐛 Fixes & Improvements
#

  • Android 15+ Message Interaction: Fixed an issue where tapping a messaging island did not open the target application.
  • Android 16+ Island Grouping: Fixed force-grouping behavior so bridged islands are only grouped where Android 16+ grouping APIs exist.
  • Summary Island Clean-up: Fixed an issue where the island group summary lingered after all individual islands were dismissed.
  • CI / Quality Gating: Added GitHub Actions workflow for automated PR test verification and APK artifact generation.

📋 What’s Changed
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.6.0-dev4...v0.6.0-beta1

HyperBridge v0.6.0-dev2 🚀
#

Hyper Bridge v0.6.0-dev2 is the second development release of the v0.6.0 cycle!

This milestone introduces contextual Smart Action Buttons (one-tap OTP copy, URL opening, dialing, parcel tracking, and directions), resolves critical permanent island yielding and auto-hide TTL behaviors, enhances the real-time Diagnostics engine, overhauls settings navigation and M3 Expressive UI layouts, repairs multi-language character encodings, and brings a redesigned Featured Notification Warning Banner.

⚡ Context-Aware Smart Action Buttons
#

  • One-Tap OTP Copy: Automatically detects one-time passwords and SMS verification codes from incoming message notifications and renders a dedicated copy button directly on the island.
  • Open Links & Dial Numbers: Intelligent pattern detection extracts URLs and telephone numbers from notification bodies, letting you open links or start phone calls with a single tap.
  • Track Parcels: Automatically recognizes carrier package tracking numbers and enables instant shipment lookups.
  • Turn-by-Turn Directions: Identifies shared map links (Google Maps, etc.) and street addresses in message text, offering an immediate Directions action button.
  • M3 Expressive App Exclusion Picker: Choose exactly which apps should or shouldn’t generate Smart Actions via a redesigned Material 3 Expressive bottom sheet with instant search and filter controls.

⚙️ How to Enable Smart Actions
#

  • Globally: Navigate to Settings → Global Settings → toggle Smart Actions on.
  • Per-App: Open any application in the app list (Active Apps or Library) → Island Behavior → customize or override Smart Action buttons specifically for that app.

🏝️ Island Lifecycle & Timing Fixes
#

  • Permanent Island Yielding Overhaul: Fixed an issue where the Permanent Island remained hidden indefinitely behind long-lived native focus or media notifications (#255). It now yields to native islands only momentarily on new events before gracefully restoring.
  • Accurate Auto-Hide TTL: Message and standard islands now strictly honor the user-configured Auto-Hide timeout (TTL) (#278), ensuring stale islands dismiss reliably and never remain stuck on screen.

🩺 Enhanced Diagnostics & Observability
#

  • Silent Drop Tracking: The Diagnostics event feed now records silent drops along with exact classification reasons (e.g. blocked keywords, DND, group summaries, or rate limits).
  • System Removals & Spawns: Real-time event auditing for island additions, updates, and dismissals, giving users and developers clear transparency into notification pipeline decisions.

🎨 Settings Refinement & Material 3 Expressive UI
#

  • Streamlined Settings Hierarchy: Global Settings is now front-and-center as the primary entry point, with descriptive subtitles outlining island behavior, engine selection, inline replies, and smart actions.
  • Guides & Help Reorganization: Moved system setup and permission walkthroughs into a consolidated “Guides and help” section for cleaner navigation.
  • Redesigned Featured Notification Banner: Replaced intrusive dialogs/banners with an expressive FeaturedNotificationWarningBanner located cleanly beneath the top app bar exclusively on the Active Apps page, complete with an expandable detail dialog.
  • Consistent Component Padding: Standardized card margins, toggle alignments, and content-to-action spacing across all configuration subscreens.

🌍 Translations & Encoding Repairs
#

  • Mojibake / Character Encoding Repair: Fixed corrupted special characters across community translations (Russian, Ukrainian, Polish, French, Hungarian, Indonesian, etc.) (#309) and integrated automated sanitization tooling.
  • Spanish Localizations & Credits: Added full Spanish translations (values-es-rES and values-es-rEM) for call stages and new settings strings, alongside community credits for System Islands & Enhancements.

What’s Changed
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.6.0-dev1...v0.6.0-dev2

HyperBridge v0.6.0-dev1 🚀
#

Hyper Bridge v0.6.0-dev1 is the first development release of the v0.6.0 cycle!

This release introduces native system islands for Screen Recording and VPN, overhauls the core notification lifecycle for zero-latency performance, integrates messaging deduplication and call state machines, adds step-by-step floating notification setup guidance, connects to the new web documentation & changelog platform, brings brand-new dedicated Diagnostics and Bug Report screens, and completely redesigns the per-app configuration experience with dedicated subscreens and integrated Island Widget management.

📱 Redesigned App Configuration Screen & Subscreens
#

  • Full-Screen Workspace Migration: Migrated away from cramped modal bottom sheets on the Active Apps and Library tabs to a dedicated full-screen AppConfigScreen with complete gesture and hardware back-stack support.
  • Expressive Card Grouping: Replaced cluttered inline accordion dropdowns with 3 distinct connected card groups using variable-corner shapes inspired by the Theme Creator:
    1. Core Behavior & Filters (Active Notification Types, Island Behavior, Blocked Terms).
    2. Island Widgets (Per-app widget management).
    3. Future Extensions (Custom Design & Custom Translators with prominent “COMING SOON” badges).
  • Dedicated Subscreen Navigation: Smooth horizontal animated transitions into dedicated subscreen containers (SubscreenScaffold), complete with tonal back buttons matching the InfoScreen design.
  • Streamlined Island Behavior: “Use Global Defaults” is now the top-level option; tweaking any slider or toggle seamlessly converts settings into custom overrides, while re-enabling global defaults instantly clears overrides back to defaults.
  • Blocked Terms Vertical List: Blocked keywords are now organized in clean, separate containers featuring an input box card on top and an expressive vertical list below with one-tap removal.
  • Future Extension Previews: Added dedicated placeholder subscreens for upcoming community Custom Designs and Custom Translators with direct links to track progress on GitHub.

🧩 Unified Island Widgets Management
#

  • Reusable App-Filtered Widget Picker: Clicking “Add Widget” in the app configuration screen opens the unified WidgetPickerScreen automatically filtered to providers from that specific application, auto-expanding its widget list and adapting the title to “Select Widget”.
  • Live Configuration & Editing: Selecting any widget immediately transitions into WidgetConfigScreen to configure custom sizes, render modes, timeouts, and shade overlays. Configured widgets in the app list can also be tapped directly or edited via an edit icon button.
  • Adaptive Live Previews: Widget previews in the list dynamically scale their container height to match the configured WidgetSize (SMALL, MEDIUM, LARGE, XLARGE, ORIGINAL), with proper measure and layout constraints for crisp rendering.
  • Floating Action Button: Moved the “Add Widget” trigger to a prominent FloatingActionButton with comfortable bottom scroll padding.

🌐 New Documentation Website & Offloaded Changelogs
#

  • Dedicated Docs Platform: We have launched our official documentation website! Complete changelogs, setup guides, and technical explanations have moved to the web to keep the app lightweight and documentation easily searchable.
  • Direct In-App Navigation: The Info screen now links directly to the online documentation and release notes, ensuring you always have access to the latest guides and version history.

🔍 New Diagnostics & Bug Report Screens
#

🩺 Real-Time Diagnostics Screen
#

  • Subsystem Health Checks: Live status indicators for Notification Listener Service connection, POST_NOTIFICATIONS permission, HyperOS Island hardware support, and Featured Notification permissions.
  • Live System Metrics: Instant visibility into active island counts, active widget tracking, and selected allowed apps.
  • Rolling Sanitized Event Log: An in-app diagnostic log viewer showing recent notification events and translation statuses in real-time, making it effortless to see why a particular notification did or didn’t become an island.
  • Material 3 Expressive Design: Clean card-based layout with full Compose preview support for faster development and inspection.

🐛 Streamlined Bug Report Screen
#

  • Automated System Profiling: Gathers device model, Android version, HyperOS build, active settings, and bridge status automatically.
  • Privacy-Sanitized Exports: Sensitive text, notification content, and personal information are automatically scrubbed and redacted.
  • One-Tap GitHub Ready Formatting: Formats your issue into a structured, clean Markdown template and copies it directly to your clipboard so you can paste it straight into GitHub Issues.

🚀 Key Highlights & New System Islands
#

🎥 Native Xiaomi Screen Recording System Island
#

  • Live Recording Ticker: Dynamic island ticker displaying active recording duration in real time.
  • Direct IPC Controls: Full interaction with Xiaomi’s screen recorder service (com.miui.screenrecorder) via IPC to pause, resume, and stop recordings directly from the island.
  • Saved Completion Banner: Quick-access summary and preview banner with action handlers when a screen recording finishes saving.
  • Dedicated Settings: Custom configuration screen to adjust screen recording island behavior.

🛡️ VPN Connectivity & System Island
#

  • System-Level Observer: Monitors VPN network capabilities (TRANSPORT_VPN) natively without needing root or Shizuku.
  • Known Provider Adapters: Out-of-the-box support for popular VPN providers (WireGuard, OpenVPN, Cloudflare 1.1.1.1 WARP, ProtonVPN, Tailscale, Mullvad, and more).
  • Active Status & Disconnect: Displays live connected duration, country flag resolution, and offers a one-tap disconnect button right from the island.
  • System Integrations Tab: Conveniently manage VPN and system island toggles separate from regular apps.

⚡ Performance & Core Lifecycle Overhaul
#

  • Zero-Latency In-Memory Dispatch: Moved preference lookups on the hot notification path to cached in-memory state flows, eliminating SQLite/DataStore I/O bottlenecks.
  • Generation Gating (SourceProcessingGeneration): Automatically supersedes outdated translation jobs during rapid notification updates.
  • Expiry Registry (ExpiredIslandRegistry): Tracks expired notification state to eliminate ghost islands, resurrecting dismissed notifications, and visual flicker.
  • IslandUpdateResolver: Reconciles incoming changes against existing active islands, updating state smoothly in-place.

💬 Messaging & Call Enhancements
#

  • Presentation Family Tracking: Correlates group summaries and per-conversation child notifications across apps like WhatsApp, Telegram, and Signal.
  • Fingerprint Deduplication: Identifies and suppresses duplicate notification popups during rapid message bursts (“chat storms”).
  • Call Lifecycle State Machine: Classifies and manages Incoming, Ongoing, Held, and Ending call states with dedicated microphone live/muted indicators.

🎨 UI & Setup Guidance
#

  • Floating Notification Setup: Step-by-step guidance to disable Xiaomi’s native floating heads-up notifications per app to avoid visual duplication over islands.
  • System Integrations Section: Separates built-in system modules (Screen Recording, VPN) from standard third-party apps for clearer management.

🛠️ Stability & Framework Fixes
#

  • SecurityException Guard: Safely guarded calls to NotificationListenerService.activeNotifications before the listener service connects or after disconnection.
  • Safe Intent Dispatch: Guarded against null or canceled PendingIntent executions.
  • Unit Test Coverage: Comprehensive suite of 243 passing unit tests covering all reducers, trackers, and translation policies.

💖 Community & Credits
#

Special thanks to Sykeptical for their foundational contributions to Screen Recording controls, messaging deduplication, call state handling, and VPN integration originally developed in their fork and integrated into HyperBridge v0.6.0.

What’s Changed
#

New Contributors
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.5.7...v0.6.0-dev1

v0.5.7: Performance & Sync Update
#

This release focuses on significant under-the-hood performance improvements and stability fixes. Version 0.5.7 marks the final minor update for the 0.5.x branch, as Hyper Bridge officially begins the development of the next major milestone: v0.6.0.

⚡ Performance & R8 Optimizations
#

  • App Optimization Enabled: Enabled full R8 code shrinking, obfuscation, and resource shrinking. This results in a significantly smaller APK size and improved runtime performance by removing unused code and optimizing class loading.
  • Build System Upgrade: Upgraded to Android Gradle Plugin 9.3.2 and Gradle 9.5.0 to leverage the latest stability and build-time optimizations.

🛠️ Bug Fixes & Stability
#

  • Duplicate Prevention: Improved the logic for messaging apps (like WhatsApp/Telegram). The service now intelligently skips group summaries that would otherwise create redundant islands when live conversations are already active (Fixes #258 — Thanks @noelpatata2!).
  • Sync Reliability: Refined the notification synchronization engine to prevent original system notifications from being prematurely dismissed.

🌐 Localization
#

  • Added Japanese translation (Thanks @gyuhowa1122-glitch!).
  • Updated Spanish and Portuguese (BR) strings.

🤝 Acknowledgements
#

  • Added a Special Thanks section in the app settings acknowledging Stardawn for their research on the XMSF workaround that enables HyperIslands on Chinese ROMs.

What’s Changed
#

New Contributors
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.5.6...v0.5.7

v0.5.6: Landscape Hide & Stability Fixes
#

What’s Changed
#

New Contributors
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.5.5...v0.5.6

v0.5.5: Messaging & Update Fixes
#

This release focuses on significantly improving how islands handle notifications, squashing bugs related to Live Updates, and overhauling messaging grouping so your experience feels smoother and less cluttered.

✨ Features & Improvements
#

  • Messaging Grouping Overhaul: Completely reworked how messaging-style notifications (like WhatsApp) are grouped to prevent duplicate islands from spawning. (#217)
  • Permanent Island Upgrades: Improved the stability and logic for permanent/sticky islands to ensure they display and behave correctly. (#222)
  • Live Update Inline Replies: You can now use the inline reply editor directly from Android 16 Live Update notifications. (#224)

🐛 Bug Fixes
#

  • Notification Drop & Discard Logic: Fixed a critical issue where islands were not being properly removed when dismissed, and prevented random notification drops. (#221)
  • Live Update Icons: Fixed a bug where the original application icon wouldn’t display properly inside the Live Update builder. (#224)

🧹 Maintenance & Chores
#

  • Cleaned Up Localization: Safely removed 98 unused strings from the project without breaking UTF-8 encoding, resolving broken characters in localized strings. (#219)

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.5.4...v0.5.5

v0.5.4: Critical Bug Fix
#

What’s Changed
#

New Contributors
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.5.3...v0.5.4

v0.5.3: Stability & Crash Fixes
#

This release focuses on improving stability and fixing several major crashes reported in production.

🛠️ Bug Fixes
#

  • App Startup Stability: Fixed a critical double-checked locking bug in the internal database connection that caused SQLiteCantOpenDatabaseException and exhausted file descriptors during warm starts.
  • Theme Creator Reliability: Fixed a ConcurrentModificationException when saving themes by ensuring thread-safe map copying during background generation.
  • MIUI Compatibility: Bypassed aggressive MIUI theme engine hooks that intercepted the standard launcher icon in the onboarding flow, causing an instant OutOfMemoryError (RecordingCanvas.throwIfCannotDraw) on Xiaomi devices.
  • Backup Resilience: Improved the JSON backup parser to catch and handle Throwable (including OutOfMemoryError), allowing the app to gracefully reject corrupted or oversized backups without crashing.
  • Predictive Back: Mitigated rare WindowOnBackInvokedDispatcher null pointer exceptions related to Jetpack Compose gestures.

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.5.2...v0.5.3

v0.5.2: Inline Reply, Performance & Stability
#

This release brings a brand new inline reply experience, allowing you to respond directly from the island, along with major performance optimizations and crash fixes.

✨ New Features & Improvements
#

  • Inline Reply Overlay: Implement a brand new Inline Reply overlay! Reply to messages directly from the island without opening the app.
  • Inline Reply Customization: Fully customize the look of the new inline reply editor globally or per-app via the new Global Settings -> Inline reply section.
  • Service Memory Overhaul: Overhauled NotificationListener memory architecture to use an in-memory ConcurrentHashMap, dropping background CPU overhead and database reads to 0%.
  • Warm Start Performance: Deferred AppDatabase allocation and moved getPackageInfo requests off the main UI thread, vastly improving warm start performance on ARM Cortex-A75 / Mali G52 architectures.

🐛 Bug Fixes
#

  • Theme Creator Crash: Migrated to ConcurrentHashMap to resolve ConcurrentModificationException during theme asset generation.
  • WelcomePage ANR: Replaced synchronous PackageManager operations with standard painterResource to prevent WelcomePage ANR (Input Timeout).
  • Widget Picker OOM: Offloaded toBitmap scaling to Dispatchers.IO and enforced dimension coercions to eliminate RecordingCanvas.throwIfCannotDraw constraints and OOM crashes.
  • UI Layout Exceptions: Replaced rigid .heightIn(min = XX.dp) with .defaultMinSize(minHeight = XX.dp) globally to prevent Jetpack Compose Layout Constraint Exceptions on smaller screens.
  • Backup Errors: Re-routed Gson to consume native InputStreamReader streams, dramatically reducing heap usage and preventing OutOfMemoryError on large JSON backups.

What’s Changed
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.5.1...v0.5.2

v0.5.1: Fixes & Refinements
#

This release focuses on major bug fixes regarding notification stability, quality-of-life improvements, and permission handling for Xiaomi devices.

🐛 Bug Fixes
#

  • WhatsApp Duplicates Fixed: Resolved an issue that caused duplicate WhatsApp notifications to appear.
  • Notification Flicker & Crashes Fixed: Fixed a crash caused by receiving multiple notifications in a short timeframe. Previously, the app would cancel and recreate notifications upon updates; it now safely updates notifications normally, completely eliminating the notification flicker and improving stability.
  • Notification Intents Restored: Fixed an issue where clicking a featured notification would incorrectly route to the troubleshooting screen instead of the original app (e.g., Spotify, WhatsApp). Notifications now route correctly when permissions are granted!
  • Settings UI Polish: Restored the missing rounded corners on the “Permanent Island” option in the Global Settings list for a cleaner aesthetic.
  • Improved Fallback Notifications: If HyperBridge detects that the system cannot render a Featured Notification, it falls back to a standard Android notification. Clicking the fallback notification or its “Troubleshoot” action button now directly opens the Troubleshooting guide.

✨ New Features & Improvements
#

  • Remove Island on Dismiss: Added a new option to automatically remove the island if the original system notification is dismissed.
  • Featured Notifications Diagnostics: Added a new check screen during Onboarding to verify if your Xiaomi device supports Featured Notifications and if the required system permissions are enabled.
  • Setup Health Integration: The “Featured Notifications” permission status is now continuously monitored and displayed inside the Setup Health screen (under the Permissions section). You can quickly jump to System Settings from there.
  • Troubleshooting Screen: Added a dedicated Troubleshooting Screen that guides users on how to enable the necessary hidden system permissions (or use Shizuku) to get islands working on strict Xiaomi ROMs.
  • Clearer Terminology: Renamed the “Live Updates” section in the settings menu to “Notification Management” to better reflect its purpose and avoid confusion with native Live Update engines.
  • Spanish Translations: Added full Spanish translations (es-rES) for all the new troubleshooting dialogues, setup health checks, and notification management settings.

What’s Changed
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.5.0...v0.5.1

v0.5.0: The Live Update
#

Hyper Bridge 0.5.0 is a massive feature release bringing full support for Native Live Updates, CN ROMs, a completely overhauled theme engine, dedicated layouts, and major system improvements.

🌟 Headline Features
#

  • ⚡ Native Live Updates Support

    • Full support for Native Android 16/HyperOS Live Updates.
    • Requirement: Requires HyperOS 3.0.3xx+ or higher.
    • Added as a brand new option in the Engine Selector (available globally or per-app), allowing you to choose between the custom “Xiaomi Featured Design” or native system Live Updates.

  • 🇨🇳 Full CN ROM Support (Sui & Shizuku)

    • Added a dedicated workaround using Sui and Shizuku allowing users on HyperOS CN (Chinese) ROMs to fully enjoy Hyper Islands without needing native system support.
    • Ensures seamless network operations and bypasses regional limitations on notifications.

  • 🧠 Intelligent Permanent Island

    • Always Visible: You can now choose to keep the empty island permanently on your screen even when there are no active notifications.
    • Auto-Hide Logic: The permanent island is smart—it automatically hides itself whenever an active widget is shown on the screen to prevent awkward UI overlaps.
    • Customize the width of the permanent island directly from the settings to perfectly match your camera cutout.

  • 🎨 Theme Engine & Color Customization Improvements

    • New HSL Color Picker: Replaced standard hex fields with a beautiful new HSL (Hue, Saturation, Lightness) bottom sheet color picker for ultra-precise theme customization.
    • Engine Selection: You can now choose between the “Xiaomi Featured Design” or “Native Android Live Updates” on a per-app basis or globally.
    • Layered Behavior Controls: Set custom timeouts and popup logic directly within themes.
    • Shizuku Toggle: Added the Shizuku workaround toggle directly to the Theme Editor Engine tab for easy access.

  • ⬇️ Dedicated Downloads & Text Progress

    • New Download Layout: Downloads now have a completely separated layout and visual design from standard progress bars, finishing with a satisfying “Green Tick” animation.
    • Text Progress Support: The engine now parses raw percentage text (e.g., “12%”) from notifications, allowing apps that don’t use native progress bars to still trigger the island.
    • Smart Filtering: Text-based progress is strictly filtered to store and installer downloads to prevent false triggers on regular status notifications.

  • ⚙️ Advanced Island Behaviors & DND

    • Do Not Disturb (DND): You can now enable DND mode to suppress island popups when you don’t want to be interrupted.
    • Remove Original Notification: A highly requested new option allows you to automatically remove the original system notification when it’s being displayed in the Island, keeping your status bar completely clean.
    • Custom Heads-up Popups: You can now define exactly how long the floating “heads-up” popup shows before smoothly transitioning back into the collapsed island.

  • 💡 Smart Icon Tinting

    • Implemented a new detection system that automatically analyzes extracted app notification icons. If an icon is dark or monochrome (making it invisible on the black island background), the system will intelligently tint it white.

🛠 System, UX & Bug Fixes
#

  • New Onboarding Experience: Completely redesigned the onboarding flow into an 11-page guided setup, making it significantly easier to grant critical permissions, configure engines, and set up island behaviors on your first launch.
  • Direct Boot Support: The service now supports Direct Boot (LOCKED_BOOT_COMPLETED), meaning it starts immediately and reliably after a device restart—even before you unlock your phone for the first time.
  • Widget Enhancements:
    • Added a “Favorites” system and “Recommended” filter for the Widget Picker to quickly find island-compatible 1x4 and 2x4 widgets.
    • Added a “Kill Active Widgets” action to instantly dismiss all running overlays.
  • Messaging Fixes:
    • Fixed missing sender avatars in apps like Telegram (now accurately extracts "sender_person" data).
    • Resolved issues where grouped notifications (chat summaries) failed to trigger the island.
    • Fixed island disappearance bugs caused by notification update race conditions (e.g., rapid progress updates).
  • Navigation 3 Migration: Fully migrated app routing to AndroidX Navigation 3, resulting in faster, smoother screen transitions and predictive back gesture support.

🌍 Localization
#

  • Added full French localization.
  • Updated strings across Spanish, Traditional Chinese, Italian, Indonesian, Portuguese, Hungarian, and more for all the new features.

What’s Changed
#

Closed & Fixed Issues:

  • #21: [FEAT] Opción para desactivar las notificaciones originales (Closed by @D4vidDf)
  • #72: [FEAT] 0.4.0 dev (build 5) FEATURE REQUESTS (Closed by @D4vidDf)
  • #94: [FEAT] Display Hyper Island even without any notification. (Closed by @D4vidDf)
  • #97: [BUG] Dose not work on Hyper Os 3CN ( Turbo 4 pro) (Closed by @D4vidDf)
  • #99: [FEAT] Improved island parameters (Closed by @D4vidDf)
  • #107: [FEAT] Move Navigation island design screen (Closed by @D4vidDf)
  • #119: Please add Do not Disturb (Closed by @D4vidDf)
  • #120: Hyper bridge double notification problem (Closed by @D4vidDf)
  • #141: [BUG] Still not working on CN device (Redmi K70 Pro) (Closed by @D4vidDf)
  • #146: [BUG] Double notification (Closed by @D4vidDf)
  • #156: [BUG] Progress bar/Download can’t close notification (Closed by @D4vidDf)
  • #158: [BUG] Crash on Phone Boot (Closed by @D4vidDf)
  • #162: [BUG] Crash Unable to start service with null on parameter specified as no-null (Closed by @D4vidDf)
  • #163: [BUG] Download popup (Closed by @D4vidDf)
  • #177: [BUG] No funciona después de la actualización del sistema (Closed by @D4vidDf)

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.4.2...v0.5.0

v0.4.2: Hotfix Update
#

Status: Hotfix Release 🩹

This is a quick hotfix update to address a critical issue introduced in the recent localization update, alongside some under-the-hood improvements.

🛠️ Fixes & Improvements
#

  • Crash Fix: Resolved a critical UnknownFormatConversionException crash that occurred when opening the app configuration menu while the device language was set to Traditional Chinese (Taiwan).
  • General: Minor bug fixes and core stability improvements to keep the Island running smoothly.

A huge thank you to the community for reporting the crash so quickly!

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.4.0...v0.4.2

v0.4.0: The Customization Update
#

Build Date: January 22, 2026 Status: Stable Release 🌟

Tip

This is a major feature update introducing the Theme Engine, Widget Support, and a complete rewrite of the Notification Core. If you are upgrading from v0.3.x, you may need to re-grant notification permissions or battery optimizations.

✨ Highlights
#

🎨 The HyperTheme Engine
#

We have unlocked full customization. You are no longer limited to the default look.

  • Theme Creator: Design your own Dynamic Island themes directly inside the app with a real-time visual editor.
  • Smart Colors: Enable useAppColors to automatically extract vibrant brand colors from the notification’s app icon (e.g., Green for WhatsApp, Blue for Telegram).
  • Icon Shaping: Customize action buttons with shapes like Squircle, Clover, Arch, Cookie, and more.
  • Granular Control: Configure specific colors for Calls (Answer/Decline) and override rules for individual apps.
  • Sharing: Export your creations as .hbr files to share with the community.

🧩 Widget Support
#

Your favorite Android widgets now live in the Dynamic Island.

  • Pin Anywhere: Access music controls, calendars, or weather widgets from the island layer.
  • Lockscreen Ready: Widgets remain visible and interactive even on the lockscreen.
  • Dual Modes: Choose between Interactive (real-time, high refresh) or Snapshot (battery-efficient) rendering.

⚠️ Important: Widgets containing scrollable lists (e.g., Todo lists, Email streams) cannot be rendered in Interactive Mode due to system limitations. Please select Snapshot Mode for these widgets to display them correctly.

⚡ Notification Engine 2.0
#

The core listening service has been rewritten for maximum stability and performance.

  • Smart Parsing: Fixed long-standing issues where notifications displayed package names (e.g., com.whatsapp) instead of message content.
  • Anti-Flicker: Implemented content hashing to eliminate UI stuttering during rapid updates (e.g., download progress).
  • Ghost Busters: Resolved race conditions that caused “ghost islands” to linger after a notification was dismissed.

🛠️ Improvements & Fixes
#

  • UI Redesign: A completely new “Design” hub with fluid carousels for managing Themes and Widgets.
  • Privacy: Added a Global Blocklist to hide specific words or spoilers from appearing on the island.
  • Navigation: Fixed issues where “Exit Navigation” buttons were missing from the notification shade.
  • Progress Islands: Fixed rendering issues where download/upload islands would collapse or fail to show action buttons.
  • Database: Migrated internal storage to Room Database for better reliability and boot persistence.
  • Stability: Fixed a NullPointerException crash when configuring apps via the bottom sheet.

🌍 Localization
#

We have moved our translation workflow to Crowdin! A massive thank you to everyone who contributed.

👉 Help translate HyperBridge on Crowdin

  • New Languages:
    • 🇮🇩 Indonesian (Bahasa Indonesia)
    • 🇹🇷 Turkish (Türkçe)
    • 🇸🇰 Slovak (Slovenčina)
  • Updated: 🇧🇷 Portuguese (Brazil), 🇵🇱 Polish, 🇰🇷 Korean, 🇺🇦 Ukrainian, 🇷🇺 Russian, 🇩🇪 German.

👩‍💻 For Developers
#

  • Theme API: Third-party apps (launchers, icon packs) can now apply themes programmatically using the com.d4viddf.hyperbridge.APPLY_THEME intent.
  • Documentation: Check the Theme Creation Guide to learn how to build .hbr packages.

🤝 Contributors
#

Special thanks to our new contributors in this cycle:

  • @alexkoala (Korean translations)
  • @ItzDFPlayer (Ukrainian translations)
  • @kilo3528 (Russian & German translations)
  • @NIICKTCHUNS & @kacskrz (Continuous localization support)

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/0.3.1...v0.4.0

v0.3.1: Backup & Polyglot Update
#

What’s Changed
#

  • Backup & Restore: Implemented a complete system to export/import settings, blocklists, and priorities via .hbr JSON files.
  • Localization: Added an in-app Language Selector and support for German (de) and Russian (ru).
  • UI Overhaul: Updated the entire settings and onboarding experience to Material 3 Expressive design (Large Top Bars, increased roundness, surface colors).
  • Onboarding: Added a Privacy Page explaining offline architecture and improved HyperOS 3.0 compatibility checks.
  • Fixes: Resolved Navigation “Exit” button rendering as an icon instead of text, and fixed App Icon loading in the Settings screen.
  • Changelog: Updated release notes for v0.3.1.

New Contributors
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/0.3.0...0.3.1

v0.3.0: The Global Update
#

What’s Changed
#

New Contributors
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/0.2.0...0.3.0

v0.2.0: The Information Update
#

What’s Changed
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/0.1.0...0.2.0

v0.1.0: The Expressive Update
#

What’s Changed
#

Full Changelog: https://github.com/D4vidDf/HyperBridge/commits/0.1.0