v0.5.5

What's New in v0.5.5 🚀

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: v0.5.4...v0.5.5

v0.5.4 - Critical Bug Fix

What's Changed

• fix: NLS reliability, Safe Mode crash loop, and implement auto-migration by @D4vidDf in #216
• fix: Clamp progress percent to [0, 100] to prevent SystemUI crash by @Wangtaotaoo in #214

New Contributors

• @Wangtaotaoo made their first contribution in #214

Full Changelog: v0.5.3...v0.5.4

🚀HyperBridge v0.5.3

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: v0.5.2...v0.5.3

🚀HyperBridge 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

• Fix/system UI crash by @D4vidDf in #204
• perf: optimize Notification Listener via synchronous memory caching by @D4vidDf in #206
• feat: implement Inline Reply overlay and theme customization by @D4vidDf in #207

Full Changelog: v0.5.1...v0.5.2

🚀HyperBridge 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

• fix(service): resolve WhatsApp duplication and update flashing/crashes by @D4vidDf in #200
• Fix: call islands lingering, permanent island flicker, and system cr by @D4vidDf in #201
• fix: implement Featured Notification diagnostics and stability refine… by @D4vidDf in #202

Full Changelog: v0.5.0...v0.5.1

Hyper Bridge 0.5.0 - The Live Update

🚀 Hyper Bridge 0.5.0

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

• master by @D4vidDf in #126
• Feat/color picker by @D4vidDf in #127
• feat(widget): add favorites, recommended filtering, and update notice by @D4vidDf in #128
• Feat/live updates by @D4vidDf in #129
• build: update project dependencies and gradle configuration by @D4vidDf in #134
• Feature/ux iprovement global configuration by @D4vidDf in #137
• feat(theme): enhance engine resolution and theme-persistent configuration by @D4vidDf in #147
• Feature/nav3 migration by @D4vidDf in #152
• Feature/duplication toggle by @D4vidDf in #153
• Feature/onboarding screen by @D4vidDf in #155
• fix(service): refine progress notification behavior and navigation state by @D4vidDf in #157
• feat(boot): add support for Direct Boot by @D4vidDf in #159
• refactor(service): refine floating behavior for progress notifications by @D4vidDf in #164
• Fix/162 bug crash unable to start service with null by @D4vidDf in #165
• Feature/permanent island by @D4vidDf in #179
• Beta/0 5 0 by @D4vidDf in #190
• Dev by @D4vidDf in #193

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: v0.4.2...v0.5.0

🚀 Hyper Bridge v0.5.0-beta 05

HyperBridge 0.5.0 is now feature complete! The upcoming versions will be focused entirely on bug fixes and stability improvements leading up to the full stable release, expected at the end of the week.

🌟 New Features & UI Improvements

• Sui Support: HyperBridge now officially supports Sui alongside Shizuku! Devices rooted with Magisk or KernelSU running Sui can now seamlessly use the engine without needing to manually launch Shizuku.
• Dedicated Download Translator: Downloads now have their own dedicated notification type and layout (DownloadTranslator), keeping them visually distinct from generic progress bars.
• Smart Icon Tinting: Introduced an intelligent detection system that analyzes extracted notification icons. If an app provides a dark or monochrome icon that would be invisible against the island's black background, the engine automatically tints it white for perfect visibility.
• Intelligent Permanent Island: The permanent island now automatically hides itself whenever an active widget is shown on the screen, preventing awkward visual overlaps.
• Theme Editor Enhancements: The "Shizuku Workaround" toggle (useful for bypassing Xiaomi network restrictions on CN ROMs) has been moved directly to the Engine tab in the Theme Editor for easier access.
• Internationalization: Hardcoded strings for the Shizuku onboarding screen and the Permanent Island settings have been fully extracted to resources and translated to Spanish (es).

🐛 Bug Fixes & Engine Improvements

• Improved Download Logic: Greatly refined the parsing logic for downloads. The engine is now much better at accurately detecting download notifications and extracting their text, titles, and exact progress percentages.
• Messaging Avatars Fixed: Resolved an issue where messaging apps (like Telegram) failed to show the sender's profile picture on the left side of the island. The engine now correctly parses the "sender_person" key from the MessagingStyle data payload instead of falling back to the device owner.
• Grouped Notifications Fixed: Fixed a bug where grouped notifications (like chat summaries) wouldn't trigger an island pop-up. The engine now bypasses the overly strict GROUP_ALERT_CHILDREN flag check and successfully triggers if the summary has valid text content.
• Island Disappearance Bug Fixed: Fixed a critical race condition during notification updates that would cause the island to instantly delete itself. Cancels and replacements are now queued sequentially to ensure the animation triggers properly.
• Smarter Heads-Up Alerts:
  • MEDIA, PROGRESS, and DOWNLOAD notifications now correctly apply .setOnlyAlertOnce(true). This guarantees their progress bars update smoothly in the background without causing annoying, repetitive Heads-Up pop-ups.
  • Standard messaging updates now explicitly apply .setOnlyAlertOnce(false). If a notification is updated with new content (e.g., a new message in an active Telegram chat), the engine forces the island to pop-up again so you never miss an update!

📦 What's Changed

• feat: introduce dedicated Download notification type and refine progress logic by @D4vidDf in #184
• Feature/sui permission by @D4vidDf in #185
• Fix/widget permanent island by @D4vidDf in #186
• Feature/better icons by @D4vidDf in #187

Full Changelog: v0.5.0-beta04...v0.5.0-beta05

🚀 Hyper Bridge v0.5.0-beta 04

This new Beta 04 fixes a problem that caused the Shizuku implementation not work on certain devices. Now Hyper Bridge wait for the notification to be sent before enabling again xmfs.

✨ What's New in the Beta

Hyper Bridge now lets you have a permanent island when you dont have any notification.

• How to enable: You can enable it under App Settings > Global Settings.

---

📦 What's Changed

• Feature/permanent island by @D4vidDf in #179

---

Full Changelog: v0.5.0-beta03...v0.5.0-beta04

🚀 Hyper Bridge v0.5.0-beta 03

Hyper Bridge 0.5.0 Beta 03 is here fixing crash on boot and the new full Support for CN ROM.

🌟 The Headline: CN ROM Full Support

After a month of investigation I'm happy to announce that I was able to add a Shizuku Workaround that will enable you to bypass Xiaomi Featured Notification whitelist by using Shizuku. Now you can enjoy the Featrured Xiaomi Notifications on all your devices

This new option needs to be enabled on the engine page on the Global Settings. All new users will see a new step on the Onboarding Screen showing how to enable the Shizuku WorkAround.

• How to enable: You can select the new engine under the Theme Editor > Engine section or via App Settings > Global Settings > Engine.

Let me know if the new setting is working on your device. Since it's a new option it mioght have problems on certain devices.

---

✨ What's New in the Beta

Hyper Bridge now also offers the option to syncronize your device Do Not Disturb to not receieve notifications while playing games or having DnD enabled.

• How to enable: You can enable DnD under App Settings > Global Settings.

---

📦 What's Changed

• #177
• #97
• #119
• #141

---

⚠️ Important Beta Notes

• Settings Sync: Due to a rebuild of the background architecture, you may need to reconfigure your Engine Options (Native vs. Xiaomi) after updating.
• System Requirements: Native Live Updates requires HyperOS 3.1 (v3.0.300.0+) or the latest System UI Plugin update.

Full Changelog: v0.5.0-beta02...v0.5.0-beta03

🚀 Hyper Bridge v0.5.0-beta 02

What's Changed

• refactor(service): refine floating behavior for progress notifications by @D4vidDf in #164
• Fix/162 bug crash unable to start service with null by @D4vidDf in #165

Note

I'm aware some users are experiencing some problems with the app not being able to read notifications under certain conditions. This second beta only brings a fix to a major crash, the remaining problems (like Hyper Birdge not being able to read Telegram Grouped notifications) will be fixed on the next version.

Full Changelog: v0.5.0-beta01...v0.5.0-beta02