thatjoshguy67/blur-widget-demo

Blur Widget Demo is a proof-of-concept Android app that shows how third-party apps can apply Samsung's frosted-glass wallpaper blur effect to their home screen widgets. Samsung uses this blur behind its own Clock, Weather, and Calendar widgets on One UI 7, but does not document how it works. This project reverse-engineered the technique and packages it as a working sample. The trick involves three requirements: the widget layout must have a view with the specific ID android:id/background, that view must have a background color with an alpha value between 1 and 254 (not fully transparent and not fully opaque), and the widget metadata must include Samsung-specific attributes called widgetStyle="colorful" and a real widgetSize value. When all three are present, the Samsung launcher detects this, captures the wallpaper behind the widget, blurs it automatically, and your background color acts as a tint over the blurred result. The widget itself never renders the blur. The app ships with a single resizable widget that has a configuration screen where you can adjust the tint color and opacity in real time to see how the blur responds before using the pattern in your own app. A prebuilt signed APK is available on the releases page for sideloading directly onto a Samsung device running One UI 7.0 or newer. For developers, the project uses Kotlin, Gradle, and Android Studio with a minimum SDK of 26. Building from source requires creating a GitHub personal access token to download a Samsung UI component library from GitHub Packages. The wiki includes step-by-step guides for integrating the blur technique into your own widget and for lock screen widgets. The project is licensed under MIT.