Data Management

ATLAS provides multiple ways to move data in and out of the application. All data stays on your device unless you explicitly export or share it.

ATLAS Directory

ATLAS uses a shared directory for file transfers:

/storage/emulated/0/ATLAS/

Copy files here for easy import access. Exported files, TAK configs, and shared data can be placed in this directory.

Project Export

Export complete projects for backup, reporting, or transfer to another device.

How to Export

Open the project
Tap Export button
Select what to include:
- Project details (metadata)
- Notes
- Points of Interest (POIs)
- Cards (with full RFID data)
- Situational awareness items (entry points, barriers, cameras, personnel)
Optionally set a password for AES-256 encryption
Optionally include a map screenshot

Export Location

Files are saved to:

/Android/data/io.mwgroup.atlas/files/exports/

File naming:

ProjectName_YYYY-MM-DD.json — Standard export
ProjectName_YYYY-MM-DD_encrypted.json — Password-protected export

Project Import

Import projects from other ATLAS devices or backups.

How to Import

Go to Projects
Tap the ↑ (import) icon in the top right
The file picker opens to /storage/emulated/0/ATLAS/
Navigate to your .json export file
If encrypted, enter the password
If a project with the same ID exists, choose Replace or Create New

Tip: Copy export files to /storage/emulated/0/ATLAS/ for easy access.

Map Screenshots

Capture high-resolution map images for reports and documentation.

Standalone Screenshot

Open the Map view for your project
Tap ⋮ menu → Export Map Screenshot
Image saves to the exports folder

With Project Export

When exporting a project, enable “Include map screenshot” to generate a facility overview image alongside your JSON data.

Screenshots include:

All visible situational awareness markers
Camera viewing cones
Entry points, barriers, and personnel positions
Fence/barrier polylines
POI markers

KML Export

Export GPS data to KML format for Google Earth, TAK, and other mapping tools.

Card Database Export

Go to Cards → Card Database
Tap ⋮ menu → Export to KML
All cards with GPS coordinates export as placemarks

Project GPS Export

Open project → Map view
Tap ⋮ menu → Export KML
Exports all project GPS data:
- Cards
- POIs
- Notes
- Situational awareness items

File Manager

ATLAS includes a built-in file manager for PM3 files, traces, and exports.

Viewing Files

Go to Settings → File Manager to browse:

Dumps — PM3 dump files (.bin, .eml, .mfd)
Keys — Key files (.dic, decryption files)
Traces — Raw capture traces
Exports — Project exports and screenshots
Logs — Session logs

Long-press any file for options:

Action	Description
Save to Downloads	Copy to device Downloads folder (decrypts if encrypted)
Share via…	Share using Android share sheet (decrypts if encrypted)
View	Open file contents in viewer
Rename	Change filename
Delete	Remove file permanently

Importing Files

Open File Manager
Tap + (import) button
Select file type to import
Navigate to your file in the ATLAS directory or device storage
File is copied to ATLAS internal storage

TAK Server Push

Push project data to your TAK server for team visibility.

Configure TAK server in Settings → TAK Configuration
Open project → Map view
Tap ⋮ menu → Push to TAK Server
Select what to push:
- Cards
- POIs
- Notes
- Situational awareness items

Data exports as KML and uploads to your TAK server’s file sync API.

Data Format Summary

Data Type	Export Format	Import Format
Projects	`.json` (encrypted or plain)	`.json`
Map Data	KML, PNG screenshot	—
Cards	KML (GPS only), included in project JSON	Via project import
PM3 Files	Binary (share via file manager)	Binary (import via file manager)

Encryption

All exported project files can be encrypted with a password:

Algorithm: AES-256-GCM
Key derivation: PBKDF2
Filename indicator: _encrypted suffix

When importing encrypted files, you’ll be prompted for the password. There is no password recovery—keep your password secure.