Hyper Bridge
0.6.0-rc4 · GitHub
More about this app
Brings the native HyperIsland experience to HyperOS by bridging notifications into the camera cutout UI with themes and widgets
Hyper Bridge
Bring the native HyperIsland experience to third-party apps on HyperOS.
Hyper Bridge bridges standard Android notifications into the pill-shaped UI around the camera cutout, offering a seamless, iOS-like experience on Xiaomi phones. Now with full theme customization and widget support.
๐ Features
- Native Visuals: Transforms notifications into HyperOS system-style islands.
- ๐จ Theme Engine: Customize every pixel.
- Theme Creator: Built-in editor to design your own themes with real-time previews.
- Smart Colors: Automatically extract vibrant brand colors from app icons.
- Icon Shaping: Choose between shapes like Squircle, Clover, Arch, and Cookie.
- Granular Control: Per-app overrides for colors, icons, and action styles.
- Smart Icon Tinting: Intelligently tints dark/monochrome icons to remain visible.
- ๐งฉ Widgets: Pin standard Android widgets to the island layer for quick accessโeven on the Lockscreen!
- ๐ง Intelligent Permanent Island: The permanent island now automatically hides itself whenever an active widget is shown on the screen, preventing awkward overlaps.
- Smart Integration:
- ๐ต Media: Show album art and "Now Playing" status with visualizer support.
- ๐งญ Navigation: Real-time turn-by-turn instructions (Google Maps, Waze).
- โฌ๏ธ Downloads: Dedicated circular progress layout with a satisfying "Green Tick" animation upon completion.
- ๐ Calls: Dedicated layout for incoming and active calls with timers.
- ๐ก๏ธ Spoiler Protection: Define blocked terms globally or per-app to prevent specific notifications (e.g., message spoilers) from popping up on the Island.
- Sui & Shizuku Support: Fully supports Sui and Shizuku for enhanced network operations and seamless integration on rooted devices.
- Total Control: Choose exactly which apps trigger the island, customize timeouts, and toggle floating behavior per app.
๐ฉโ๐ป For Developers: Create Themes
HyperBridge supports an open theming standard (.hbr packages). You can create themes and distribute them, or integrate a "Apply Theme" button directly into your own app (Launcher, Icon Pack, etc.).
- Documentation: Full Guide on Creating & Distributing Themes
- Intent API: Send themes programmatically using
com.d4viddf.hyperbridge.APPLY_THEME.
๐ Supported Languages
HyperBridge is fully localized thanks to our amazing community. Want to add your language? We now use Crowdin for easy translation management.
๐ Help translate HyperBridge on Crowdin
- ๐บ๐ธ English (Default)
- ๐ช๐ธ Spanish (Espaรฑol)
- ๐ง๐ท Portuguese (Portuguรชs Brasileiro) โ Thanks to @NIICKTCHUNS
- ๐ต๐ฑ Polish (Polski) โ Thanks to @kacskrz
- ๐ธ๐ฐ Slovak (Slovenฤina)
- ๐ฐ๐ท Korean (ํ๊ตญ์ด) โ Thanks to @alexkoala
- ๐บ๐ฆ Ukrainian (ะฃะบัะฐัะฝััะบะฐ) โ Thanks to @ItzDFPlayer
- ๐ท๐บ Russian (ะ ัััะบะธะน) โ Thanks to @kilo3528
- ๐ฉ๐ช German (Deutsch) โ Thanks to @kilo3528
- ๐ฎ๐ฉ Indonesian (Bahasa Indonesia)
- ๐น๐ท Turkish (Tรผrkรงe)
๐ ๏ธ Tech Stack
- Language: Kotlin
- UI: Jetpack Compose (Material 3 Expressive)
- Architecture: MVVM
- Storage: Room Database (SQLite)
- Services: NotificationListenerService, WidgetOverlayService
- Concurrency: Kotlin Coroutines & Flow
๐ธ Screenshots
| Home Screen | Active Island | Theme Creator | Widget Picker |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
๐ค Acknowledgements
Special thanks to the following people and projects for their invaluable contributions:
- Stardawn: For the extensive research on the XMSF notification workaround that enables HyperIslands on Chinese ROMs.
๐ฅ Installation
Option 1: Google Play Store (Recommended)
The easiest way to install and keep the app updated.
Option 2: Manual APK
- Download the latest APK from the Releases page.
- Install the APK on your Xiaomi/POCO/Redmi device.
โ๏ธ Setup (Required for both methods)
- Grant "Notification Access" when prompted.
- Critical: Follow the in-app guide to enable Autostart and No Restrictions (Battery) to prevent the system from killing the background service.
๐ค Contributing
Contributions are welcome! Please read our Contributing Guidelines before submitting a Pull Request.
- Fork the repository.
- Create a new branch (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'Add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
๐ Support the Project
Hyper Bridge is an open-source project developed in my free time. If this app has improved your daily experience, please consider supporting its development!
๐ License
Distributed under the Apache 2.0 License. See LICENSE for more information.
๐ค Developer
D4vidDf
- Website: d4viddf.com
- GitHub: @D4vidDf
How Shizuku is used
Can pause Xiaomi messaging networking around island alerts and identify the active VPN app via `setUidFirewallRule` and `getVpnConfig` through Shizuku
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Shizuku is used to improve island notifications on Xiaomi ROMs and to identify the active VPN app for the VPN island display.
- Pause messaging networking: when the optional workaround is turned on, the app briefly blocks network access for the Xiaomi system messaging service just before posting, updating or clearing an island notification, then restores access about a second later, using hidden firewall controls through Shizuku.
- Identify active VPN app: when system based VPN detection is allowed, the app reads the active VPN configuration through Shizuku to find which VPN app owns the current tunnel, so the island can show the correct provider name and status.
Android APIs or commands used
IConnectivityManager.setFirewallChainEnabledIConnectivityManager.setUidFirewallRuleIConnectivityManager.getVpnConfigINetworkManagementService.setFirewallChainEnabledINetworkManagementService.setUidFirewallRuleINetworkManagementService.setFirewallUidRuleIVpnManager.getVpnConfigVpnConfig.user
Notable details
The messaging networking pause is optional and off unless enabled in settings. Notifications are posted normally without Shizuku when the workaround is off. VPN identification falls back to notification evidence and the Always-On VPN system setting without Shizuku. Diagnostic log collection and device property reads run as normal app processes, not through Shizuku.
Changelog
What's new for version 0.6.0-rc4
Welcome to the fourth Release Candidate of HyperBridge 0.6.0! ๐
As we approach the final 0.6.0 release, this release candidate brings important improvements to media time tracking and live elapsed timers in Custom Translators, alongside documentation polish and refreshed multi-language translations.
โจ Features & Improvements
Configurable Timers & Stopwatches for Custom Translators (#468, #471):
- Added dedicated timer configuration options under Progress & Timing and on the Compact Pill Right Slot when
Timeris selected. - Start Reference Modes: Choose between Automatic (From Notification), First Detected (Stopwatch / Call Start), or Notification Timestamp.
- Direction: Count Up (Elapsed Stopwatch) or Count Down (Remaining Time).
- Perfect for Discord voice calls, gaming sessions, and ongoing notifications that don't natively expose Android chronometers. The session time remains anchored and won't reset on notification updates.
- Added dedicated timer configuration options under Progress & Timing and on the Compact Pill Right Slot when
Documentation & Asset Updates (#467):
- Updated README with detailed sections for Phone and Adaptive Tablet / Foldable experiences.
- Added refreshed high-resolution screenshots for Design Screen, Widget Studio, and Custom Translator split-view layouts.
Localization Updates:
- Updated translations across French, German, Hungarian, Indonesian, Italian, Korean, Polish, Portuguese, Spanish, Turkish, and Traditional Chinese.
๐ Bug Fixes
- Fixed Island Resizing on Media Counter (#469, #470):
- Integrated Xiaomi HyperOS native
sameWidthDigitInfoon Big Island for media playback counters. - Fixed visual jitter and constant island resizing caused by variable-width fonts when counting elapsed or remaining track duration.
- SystemUI now updates the timer smoothly in native count-up/countdown mode while playing, and displays fixed-width monospaced digits when paused.
- Integrated Xiaomi HyperOS native
๐ฆ What's Changed
docs: update README for 0.6.0 and refresh screenshotsby @D4vidDf in #467fix(translator): use sameWidthDigitInfo for media counter to prevent island resizingby @D4vidDf in #470feat(translator): add configurable timer start mode and direction for custom translatorsby @D4vidDf in #471
Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.6.0-rc3...v0.6.0-rc4
Permissions
10 permissions requested



