ShizuStore

Hyper Bridge

D4vidDf

0.6.0-rc4 · GitHub

Download APK
Customization Android 15+ 2 days ago Apache-2.0
799 ShizuStore
125k GitHub
443 Stars
9 MB Size

More about this app

Brings the native HyperIsland experience to HyperOS by bridging notifications into the camera cutout UI with themes and widgets

HyperBridge Logo

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.

Get it on Google Play

Version 0.5.0 Kotlin Android Material Design Crowdin


๐Ÿš€ 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.).

๐ŸŒ 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
Home Island Creator Widgets

๐Ÿค 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.

Get it on Google Play

Option 2: Manual APK

  1. Download the latest APK from the Releases page.
  2. Install the APK on your Xiaomi/POCO/Redmi device.

โš™๏ธ Setup (Required for both methods)

  1. Grant "Notification Access" when prompted.
  2. 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.

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/AmazingFeature).
  3. Commit your changes (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. 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!

Sponsor

๐Ÿ“œ License

Distributed under the Apache 2.0 License. See LICENSE for more information.

๐Ÿ‘ค Developer

D4vidDf

Close

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.setFirewallChainEnabled
  • IConnectivityManager.setUidFirewallRule
  • IConnectivityManager.getVpnConfig
  • INetworkManagementService.setFirewallChainEnabled
  • INetworkManagementService.setUidFirewallRule
  • INetworkManagementService.setFirewallUidRule
  • IVpnManager.getVpnConfig
  • VpnConfig.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.

Close

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 Timer is 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.
  • 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 sameWidthDigitInfo on 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.

๐Ÿ“ฆ What's Changed

  • docs: update README for 0.6.0 and refresh screenshots by @D4vidDf in #467
  • fix(translator): use sameWidthDigitInfo for media counter to prevent island resizing by @D4vidDf in #470
  • feat(translator): add configurable timer start mode and direction for custom translators by @D4vidDf in #471

Full Changelog: https://github.com/D4vidDf/HyperBridge/compare/v0.6.0-rc3...v0.6.0-rc4

Close

Permissions

10 permissions requested

  • com.d4viddf.hyperbridge.permission.UPDATE_SOURCE
  • android.permission.POST_NOTIFICATIONS
  • android.permission.POST_PROMOTED_NOTIFICATIONS
  • android.permission.QUERY_ALL_PACKAGES
  • android.permission.WAKE_LOCK
  • android.permission.RECEIVE_BOOT_COMPLETED
  • android.permission.SYSTEM_ALERT_WINDOW
  • moe.shizuku.manager.permission.API_V23
  • android.permission.ACCESS_NETWORK_STATE
  • com.d4viddf.hyperbridge.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
Close