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.

Transferring Files to Your Device

Use one of these methods to move files to your phone:

Method	Description
LocalSend	Cross-platform (Windows, Mac, Linux, Android, iOS). Transfers over local network—no internet required. Recommended.
USB Cable	Connect via USB in “File Transfer” mode. Navigate to Internal Storage/ATLAS/.
Cloud Storage	Download from Google Drive, Dropbox, etc. to the ATLAS folder.

---

Project Export

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

How to Export

1. Open the project
2. Tap Export button
3. Configure export options in the dialog:

PROJECT DATA

• Project Details (metadata)

LINKED ITEMS

• Notes
• POIs
• Cards (with full RFID data)

AWARENESS ITEMS

• Entry Points
• Barriers/Fences
• Security Personnel
• Cameras

MEDIA ATTACHMENTS

• Include photos & videos — When enabled, exports as .atlas bundle with media files. When disabled, exports as smaller .json file (metadata only).

ENCRYPTION

• Encrypt with password — Optional password for AES-256-GCM encryption (PBKDF2 with 100k iterations)

Export Formats

Option	Format	Description
With Media	.atlas	ZIP bundle containing project.json and all media files. Recommended for full backups.
Without Media	.json	Lightweight metadata-only export. Compatible with legacy import and reporting tools.

Export Location

Exported files are stored in ATLAS’s internal storage and accessed via the built-in File Manager (Settings → File Manager → Exports category).

To save exports to your device’s Downloads folder for external access:

1. Open Settings → File Manager
2. Filter by Exports
3. Long-press the file
4. Select Save to Downloads

File naming:

• project_projectname_YYYY-MM-DD.atlas — Bundle with media
• project_projectname_YYYY-MM-DD_encrypted.atlas — Password-protected bundle
• project_projectname_YYYY-MM-DD.json — Metadata-only export (or no media attached)
• project_projectname_YYYY-MM-DD_encrypted.json — Password-protected metadata export

---

Project Import

Import projects from other ATLAS devices or backups.

Supported Formats

Format	Extension	Description
Bundle with Media	.atlas	ZIP bundle containing project data and all attached photos/videos
Metadata Only	.json	Lightweight export without media files

How to Import

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

When importing .atlas bundles, media files are automatically extracted to ATLAS storage and linked to their parent items (Notes, POIs, SA Items, etc.).

Tip: Use LocalSend to transfer files wirelessly between devices. See Transferring Files above.

---

Map Screenshots

Capture high-resolution map images for reports and documentation.

Standalone Screenshot

1. Open the Map view for your project
2. Tap ⋮ menu → Export Map Screenshot
3. 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

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

Project GPS Export

1. Open project → Map view
2. Tap ⋮ menu → Export KML
3. 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

Sharing Files

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

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

---

TAK Server Push

Push project data to your TAK server for team visibility.

1. Configure TAK server in Settings → TAK Configuration
2. Open project → Map view
3. Tap ⋮ menu → Push to TAK Server
4. 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 (with media)	.atlas (encrypted or plain)	.atlas
Projects (metadata only)	.json (encrypted or plain)	.json
Map Data	KML, GeoJSON, PNG screenshot	—
Cards	KML (GPS only), included in project exports	Via project import
PM3 Files	Binary (share via file manager)	Binary (import via file manager)
Media Attachments	Bundled in .atlas exports	Extracted on import

---

Encryption

All exported project files can be encrypted with a password:

• Algorithm: AES-256-GCM
• Key derivation: PBKDF2 (100,000 iterations)
• Filename indicator: _encrypted suffix

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