Skip to content
  • getting started

Getting Started

ATLAS is a standalone Android platform for physical security operations. No laptop required.

What You Need

Section titled “What You Need”
Section titled “Recommended Devices”

For best results with Proxmark3 Bluetooth connectivity, we recommend:

  • Google Pixel devices running GrapheneOS or stock Android
  • AOSP-based ROMs on Pixel hardware

Known Compatibility Issues

Section titled “Known Compatibility Issues”

Proxmark3 Bluetooth Classic relies on RFCOMM/SPP, which is implemented differently across Android OEMs:

  • Samsung devices: Modified Bluetooth stack may cause connectivity issues with the Proxmark3
  • Other OEM ROMs (Xiaomi, OnePlus, etc.): Untested and may have similar issues

If you experience Bluetooth instability with your Proxmark3, consider using a Pixel device. WiFi-based hardware (Doppelganger Core, Stealth) works across all supported Android versions.

Why Android 12+

Section titled “Why Android 12+”

We intentionally do not support end-of-life Android versions due to security risks:

  • Android 11 and below no longer receive security patches from Google
  • Older versions lack standardized Bluetooth permission APIs, increasing attack surface
  • Running security-sensitive operational data on unsupported OS versions is an unacceptable risk

If your device cannot run Android 12+, we recommend upgrading to a supported device before using ATLAS for operations.

Quick Start

Section titled “Quick Start”

1. Install ATLAS

Section titled “1. Install ATLAS”

Download the APK from our Downloads page and install it on your Android device.

2. Activate Your License

Section titled “2. Activate Your License”

Launch ATLAS, accept the Terms of Service, and enter your license key. You’ll need:

  • License key (from your purchase confirmation)
  • Your name and email

3. Connect Your Proxmark3

Section titled “3. Connect Your Proxmark3”
  1. Power on your Proxmark3 RDV4 with Blueshark module
  2. Open Android Settings → Bluetooth and pair with the Proxmark3
  3. In ATLAS, tap the PM3 Connection Card on the home screen
  4. Select your Proxmark3 from the scanner

4. Grant Permissions

Section titled “4. Grant Permissions”

ATLAS requires several Android permissions to function. On stock Android (Pixel, Samsung, etc.), you may need to grant these manually:

Location Access

Section titled “Location Access”

Required for GPS tagging card reads and map features.

  1. Go to Settings → Apps → ATLAS → Permissions
  2. Tap Location and select Allow only while using the app or Allow all the time
  3. Ensure Location Services is enabled in your device settings

All Files Access

Section titled “All Files Access”

Required for exporting reports, importing card dumps, and managing the ATLAS folder.

  1. Go to Settings → Apps → Special app access → All files access
  2. Find ATLAS and enable the toggle

Nearby Devices

Section titled “Nearby Devices”

Required for connecting to Proxmark3, MSR, and Doppelganger devices.

  1. Go to Settings → Apps → ATLAS → Permissions
  2. Enable Nearby devices

Note: GrapheneOS users may see different permission prompts. The app will request permissions automatically on first launch. See the FAQ for complete permission troubleshooting.

5. Start Scanning

Section titled “5. Start Scanning”

Once connected, you can:

  • Discover Tab → Scan for LF/HF cards
  • Cards Tab → Write and clone cards
  • Database → View all captured cards
  • Map → See card read locations

Optional Hardware

Section titled “Optional Hardware”

ATLAS also works with:

Doppelgänger devices appear automatically in the Devices section when on the same network.

Need Help?

Section titled “Need Help?”