Xposed Modules

ZetaCard

Customize Google Wallet card artwork with a modern Material 3 LSPosed module for Android.

Features

  • Custom card artwork inside Google Wallet, displayed side by side with original designs.
  • Built-in crop editor with pinch-to-zoom, pan and fit-to-frame stretching.
  • Dynamic color theme (Material You) on Android 12+.
  • Automatic, cached discovery of Wallet artwork renderers surviving app updates.
  • Root-based local card list discovery and seamless data migration from older versions.

Requirements

  • Android 10 (API 29) or newer.
  • Google Wallet (com.google.android.apps.walletnfcrel).
  • LSPosed or Vector with libxposed API 102.
  • Root access (KernelSU, SukiSU, APatch or Magisk) granted to ZetaCard.

Important: Ensure "Umount modules" (or DenyList) is disabled for Google Wallet in your root manager so LSPosed can hook into its process.

Releases

1.5

Stable

11/3/2026, 4:59:26 PM

ZetaCard 1.5 (version code 150)

Fixed

  • Google Wallet could hang on its splash screen and fail to open while the module searched for artwork hooks. The search now runs in the background with a time limit, uses indexed lookups instead of a nested brute-force match, and records unsupported Wallet versions instead of rescanning on every launch.
  • Large photos (up to 6000 px) were decoded at full size and could run out of memory. Images are now down-sampled to at most 3000 px before editing.
  • Photos taken with the camera could appear rotated. Images are now decoded with ImageDecoder, which applies EXIF orientation.
  • Root commands could block indefinitely when a command wrote to standard error. Commands now have timeouts and discard standard error.
  • The welcome screen could be drawn under the status and navigation bars on Android 15, and status bar icons could be unreadable in light mode. The app now enables edge-to-edge with a day/night window theme.
  • After a Wallet update, custom artwork for already known cards could be missing until the second launch. The module now preloads known cards from its saved card list.
  • The saved card list inside Wallet only kept cards seen in the current session; previously discovered cards are now preserved.
  • The crop editor opened below the zoom needed to fill the frame, so Apply crop stayed disabled until the photo was zoomed, and pinching out could disable it again. The editor now starts filled and never zooms out past the card frame.
  • Artwork sync could corrupt the shared file when the app synced on startup while a new design was being saved. Syncs are now serialized, and unchanged artwork is no longer copied again on every app start.
  • Inside Wallet, a missing or unreadable artwork file was reopened and decoded on every frame. Failures are now remembered per artwork revision.
  • Two Wallet threads could write the saved card list at the same time.
  • Reopening ZetaCard while a slow card import was still running could freeze the app on start.
  • Pull-to-refresh did nothing visible while an automatic import was already running.
  • A malformed character reference in the old app's preferences could stop the migration from ever completing.
  • Migration from the old app could be marked finished even when a design failed to copy or its data could not be read. Each design now has its own result, migration only completes when every design is present, and the app asks you to keep the old version until then.
  • The saved hook map stored only the renderer name and parameter count, so a different overload could be hooked on the next launch. The cache now stores the full signature (format v2; older caches trigger one rescan).
  • When several card state wrappers or renderer overloads scored equally, only the first was hooked. All equally scored layouts in the same renderer class are now hooked.
  • Root command timeouts did not apply while a command kept its output open, so a stuck command could block for much longer than allowed.
  • The 45-second Wallet scan budget did not include loading Wallet's classes. It now covers the whole scan, and an unfinished scan is never cached.
  • Writing the card list, encoding original-artwork previews and the first artwork decode happened on Wallet's UI path. They now run on a background thread, and known artwork is preloaded at start.
  • The card status said "Custom artwork active" even when the design had not reached the LSPosed module. Cards now show whether a change is applied or still waiting for LSPosed.
  • Root access used the primary user's storage paths. Wallet and old-app data are now located for the current user, and only that user's Wallet is restarted.
  • Missing artwork previews were downloaded again on every return to the app, which could stall refreshes when offline. Failed previews are retried only on pull-to-refresh or the next app start.

Changed

  • The package name is now io.github.hxfuxyy.zetacard, matching the requirements of the Xposed Modules Repository. On first launch with root, designs and card names are copied from the old dev.zxcwsurx.zetacard app, and a reminder is shown until the old app is uninstalled.
  • The manager app was split into separate UI, view model, data, image, root, logging and Wallet layers, using coroutines instead of manual threads.
  • The repeated "ZetaCard · version" footer was removed. The rounded overflow menu holds the logs and an About dialog with the version and source link.
  • New app icon based on the card-shaped logo, with a matching monochrome layer for themed icons on Android 13 and newer.
  • The welcome screen opens with a new card-shaped logo in your theme colors, and lists both setup steps in one aligned panel with a clear status for each.
  • Cards show a status chip, Change and Restore actions side by side, and a confirmation before restoring the original artwork.
  • Artwork previews are decoded at display size instead of full resolution.
  • Diagnostic logs redact URLs, email addresses, private storage paths and long digit sequences.
  • The version is defined once in version.properties; the duplicated version entry was removed from module.prop.
  • Production releases are built from the release variant, signed with a permanent key and published with SHA-256 checksums. Preview builds are uploaded as CI artifacts instead of public releases.

Added

  • Unit tests for crop geometry, image sampling, card IDs, card registry parsing, artwork URL validation, log redaction, hook discovery and module metadata.
  • CI, release and CodeQL workflows, Dependabot, ktlint, and project documentation.
  • A separate, re-runnable workflow publishes an existing release to the Xposed Modules Repository.

Upgrade notes

  • 1.5 installs next to the old app because the package name changed. Open it once with root to copy your designs, uninstall the old app, then enable the new module in LSPosed for Google Wallet.

Requirements

  • Android 10 or newer, Google Wallet
  • LSPosed or Vector with libxposed API 102
  • Root access granted to ZetaCard

Installation

Install the APK, enable ZetaCard in LSPosed with Google Wallet in scope, then force stop and reopen Wallet.

Verification

  • APK SHA-256: 7239c42f42b5bc7021d0610087a9c9a6d7f99fd0acee4ed0c153c6d5ea50e6f5
  • Signing certificate SHA-256: 98de88625d96d202de8668acdb618eb16b418e50cd901d487ecbb28c60741459

Assets

1