Punch-hole Download Progress

Xposed module that displays download progress as an animated ring around the camera cutout.

Features

- Progress ring rendered around the camera cutout using the native DisplayCutout API. - Customizable appearance: colors per state (active/completed/failed), arc thickness, opacity, and direction. - Completion animations and optional haptic feedback. - Active download counter badge. - Battery saver-aware rendering. - Built-in test mode for simulating states. - Material 3 Expressive settings UI with Jetpack Compose.

Requirements

- Android 12 (API 31) or higher. - LSPosed (JingMatrix fork recommended). - Pixel or AOSP-based ROM. - Root access (optional, for Restart SystemUI in settings). - A phone with a punch-hole display.

Installation

1. Download the APK. 2. Install and enable the module in LSPosed. 3. Scope to com.android.systemui. 4. Restart SystemUI or reboot the device.

The app includes a built-in Restart SystemUI option in the overflow menu. Magisk will prompt for permission; KernelSU/APatch require adding the app manually.