English | 简体中文
An NFC Card Emulator that actually works on Pixel phones, root not required.
PixelCardEmulator enables NFC-A (ISO 14443-A) card identity (UID) emulation on Google Pixel and select devices without root, unlocking custom UID simulation previously blocked by Android's randomized HCE UID policy.
- No Root Required: Grants the one-time
WRITE_SECURE_SETTINGSpermission through Shizuku, on-device wireless debugging, or computer ADB. - Dual Emulation Backends:
- OEM Extension (Android 15+): Uses platform
NfcOemExtension.emulateNfcTechnologyATag. - Raw NCI Fallback: Direct controller communication via vendor NCI commands with automatic parameter snapshot and restore.
- OEM Extension (Android 15+): Uses platform
- UID Support: 4-byte, 7-byte, and 10-byte NFC-A UIDs.
- Card Management: Read cards via NFC, enter hex UIDs manually, set default card, and mask UIDs for privacy.
- Material 3 Expressive UI: Dynamic Color, smooth transitions, swipe actions, and haptics.
These demo screenshots were captured from the Android Emulator. The editor uses the non-sensitive example UID 04 A1 B2 C3.
|
Card list with the saved demo card |
Add a card and edit its example UID |
- Device: Google Pixel running Android 15+ (or compatible Samsung / OnePlus / Sony devices via Raw NCI).
- Permission:
android.permission.WRITE_SECURE_SETTINGS(granted once through one of the setup methods below).
- Install the APK.
- Open the app and choose one permission setup method:
- Shizuku: Start Shizuku, tap Grant with Shizuku, and approve the request.
- Wireless debugging: Tap Grant with wireless debugging. In Developer options, open Wireless debugging → Pair device with pairing code, then enter the code from the setup notification.
- Computer ADB: Run:
adb shell pm grant io.github.realtvop.pixelcardemulator android.permission.WRITE_SECURE_SETTINGS
- Enable NFC, open the app, scan or add your card, and tap to activate.
- UID Only: Emulates only the ISO 14443-A UID (
NFCID1). Does not emulate encrypted card data (e.g. MIFARE Classic sectors, DESFire crypto, or bank payment cards). - Authorized Use Only: Use the app only with cards and systems you own or are explicitly authorized to test.
- On-Device Only: Network access is used only to connect to Android's wireless ADB service on the same device during permission setup. The app does not upload card UIDs and includes no analytics or telemetry.
- Raw NCI Safety: Raw NCI mode temporarily changes NFC controller parameters and automatically snapshots and restores the original configuration.
- Explicit Permission Grant:
WRITE_SECURE_SETTINGSis granted only after the user explicitly chooses Shizuku, wireless debugging, or computer ADB setup.
./gradlew assembleDebugF-Droid listing text, changelog, and emulator screenshots are stored in fastlane/metadata/android/. The F-Droid build workflow validates the source build with the F-Droid buildserver container.
Create a local keystore and Gradle signing properties when preparing the first release:
./scripts/prepare-signing.sh
./gradlew assembleReleaseKeep release-keystore.jks and keystore.properties private. For the release workflow, add these repository Actions secrets:
ANDROID_KEYSTORE_BASE64: base64-encodedrelease-keystore.jksANDROID_KEYSTORE_PASSWORDANDROID_KEY_ALIASANDROID_KEY_PASSWORD
Push a tag such as v0.1 to build the signed APK and create a draft GitHub release with the APK attached. Every pushed commit also produces an unsigned debug APK in the Development Build workflow's Actions artifact; it is not published as a release.
Licensed under the Apache License 2.0.