PrismLock logo

PrismLock

Fingerprint icons and touch animations for Samsung devices.

Release LSPosed Build Source

PrismLock is an Xposed / LSPosed module that replaces fingerprint icons and touch effects on Samsung One UI. Choose a design from the built-in catalog or import your own PNG or Lottie artwork. Changes save automatically.

The module hooks Samsung's fingerprint asset loader instead of modifying a system APK. That is the same device-independent technique used by RingPrint: it works across Samsung devices and One UI builds, not only on one model or firmware version.

Download

Download the latest APK from Releases. Open the newest release, expand Assets, and download PrismLock-*.apk. The source ZIP/TAR files are not installable apps.

Current version: 1.0.4.

Compatibility

Component Requirements
Module framework LSPosed / compatible framework with modern libxposed API 102 support
Devices Samsung One UI with an in-display fingerprint sensor
Android 8.0 or newer (API 26+)
Module scope com.samsung.android.biometrics.app.setting
Reference device Galaxy S23 / SM-S911B

PrismLock does not target a specific Samsung model. It intercepts the fingerprint resources Samsung requests at runtime, so the same APK works across One UI devices.

Installation

  1. Download and install the APK from Releases.
  2. Use a framework supporting libxposed API 102, activate PrismLock, and select only the scope listed above. If upgrading from 1.0.3 or older, recheck module activation after the API migration. Restart the scoped process or reboot so Samsung loads the new module code; an already running legacy process retains its old clipping behavior until restarted.
  3. Follow LSPosed's activation/restart requirements.
  4. Open PrismLock and select a fingerprint and animation. There is no Apply step.
  5. If you use LockStar, turn off its fingerprint effect to avoid overlapping effects.

If you previously used the old com.fpring.samsung research package, uninstall it before enabling PrismLock. The packages are different and preferences do not migrate.

Updates

PrismLock checks GitHub Releases in the background whenever the app enters the foreground. A newer stable version is offered directly on the current screen; Settings → App → Updates also lets you check manually. Concurrent checks share one network request, and a failed request can be retried immediately.

The APK is downloaded directly from GitHub and installed in place. Rooted devices use a silent pm install; otherwise Android's system installer asks for confirmation. Your settings and selections are preserved.

Features

  • Built-in library of 36 fingerprint designs and 21 touch animations.
  • Independent fingerprint and effect selection with automatic saving.
  • Color, black/light-mode and white/AOD variants for Prism, Vortex, Orbit and Neon.
  • PNG and Lottie imports for light and dark/AOD modes.
  • Separate fingerprint and animation previews with visible-bound size normalization.
  • English interface with system, light and dark appearance.
  • Smaller 0.8-second Aqua effect with a transparent final frame.
  • Customization switch to pass through to Samsung's default visual resources.
  • Modern libxposed API 102 integration with background configuration loading.
  • Recycled catalog rows and asynchronous thumbnail/wallpaper loading.
  • Enlarged icon glows can extend beyond the Lottie artboard on compatible Samsung renderers.
  • In-app GitHub update checker and installer, with automatic foreground checks.

The module changes visual resources only. It does not change authentication, enrollment, illumination masks, brightness control or sensor behavior.

Screenshots

Fingerprints Animations Settings
Fingerprint catalog Touch animation catalog PrismLock settings

Source and build

Requires JDK 21, Android SDK platform 36 and Python 3.10+ for catalog validation. Gradle 8.13 is pinned in the checked-in wrapper.

export ANDROID_HOME=/path/to/your/android-sdk
python3 scripts/check_catalog.py
./gradlew --no-daemon assembleDebug

On Windows use gradlew.bat. The debug APK is in app/build/outputs/apk/debug/app-debug.apk. For signed distribution builds, follow release signing; never commit credentials or keystores.

app/                 Android application, hooks and runtime artwork
docs/                Architecture, release signing, testing and provenance
gradle/wrapper/      Pinned build wrapper
scripts/             Catalog validation and icon generation
.github/             CI and issue/PR templates

See architecture, release signing, release validation, contributing, security and changelog.

Credits

Developer: AurelioMo. Report bugs and suggestions through Issues.

Original catalog reference and artwork: custombeta / Fingerprint Catalog. Samsung integration research: ELPEDR / RingPrint. Aqua animation, Prism/Vortex/Orbit/Neon artwork and the PrismLock logo were supplied for this project. Samsung resources retain their respective ownership. PrismLock is not affiliated with Samsung, Xiaomi, Good Lock or LSPosed.

Third-party materials are credited here and in third-party credits. They remain the property of their respective owners and are not relicensed by this repository.

Releases

11/5/2026, 10:16:00 AM

Requirements and upgrading

This version requires a framework supporting modern libxposed API 102. Legacy-only Xposed/LSPosed frameworks cannot load PrismLock 1.0.4; update the framework before upgrading the module. Version 1.0.3 remains the last legacy release.

After upgrading, check that PrismLock is enabled for com.samsung.android.biometrics.app.setting, then restart the scoped process or reboot. A Samsung process still running the old module retains the previous scaling/clipping behavior until it restarts. Ordinary icon/effect selections still save automatically.

Changes

  • Fully migrate to libxposed 102.0.0 and modern module registration.
  • Improve app responsiveness with recycled catalog rows, asynchronous thumbnails and display-sized wallpaper decoding. Preserve the existing appearance, catalog and visual effects.
  • Fix enlarged OxygenOS/custom icon glow clipping on compatible Samsung Lottie versions by allowing artwork outside composition/parent bounds. Restore Samsung's clipping when custom artwork is disabled, without changing sensor/touch geometry. Give enlarged previews enough space for the full glow.
  • Move hook configuration loading and artwork preparation off Samsung's UI thread, retaining complete snapshots and immediate configuration-change notifications.
  • Check stable updates in the background on every foreground entry and offer them on the current screen without opening Settings. Share concurrent requests and retry failures immediately.
  • Keep PNG/Lottie imports, light/AOD variants, size controls, themes and the signed update installer.

Validation

  • 61 automated tests passed, covering API 102 hooks, caches/tint/variants/imports, clipping restoration, catalog/previews, startup update offers and installer callbacks.
  • All 57 catalog entries validated; debug/release lint completed without errors. Release certificate and APK alignment verified.
  • Installed and checked on Galaxy S23 (SM-S911B), reported Android 17 / API 37, LSPosed 2.2.1. Confirmed API 102 hook loading. Three navigation/scroll smoke tests recorded 1 janky frame out of 463 rendered frames, with 95th-percentile frame times of 5–6 ms. This sample does not establish all-model performance or compatibility.

Download PrismLock-1.0.4.apk below. Source archives are not installable apps. The APK uses the existing official release key and updates in place while preserving settings.

Assets

1