Configuration Files

Configuration Files

CyberSnap stores all configuration, history, and data in local files. This document describes the file locations and their purposes.

---

File Locations

Default Locations

Data	Location
Settings	%LOCALAPPDATA%\CyberSnap\settings.json
History database	%LOCALAPPDATA%\CyberSnap\history.db
Upload credentials	%LOCALAPPDATA%\CyberSnap\vault.dat
Capture images	%USERPROFILE%\Pictures\CyberSnap\
Recordings	%USERPROFILE%\Videos\CyberSnap\
Logs	%LOCALAPPDATA%\CyberSnap\logs\
Cache	%LOCALAPPDATA\CyberSnap\cache\
Custom sounds	%LOCALAPPDATA%\CyberSnap\sounds\

Portable Mode Locations

In portable mode (when portable.txt exists alongside the executable), all data is stored in the application folder:

Data	Location
Settings	.\Data\settings.json
History database	.\Data\history.db
Upload credentials	.\Data\vault.dat
Capture images	.\Data\Captures\
Recordings	.\Data\Recordings\
Logs	.\Data\logs\
Cache	.\Data\cache\
Custom sounds	.\Data\sounds\

---

Settings File

File: settings.json

Contains all user-configurable options:

• Hotkey bindings
• Capture settings
• Appearance preferences
• Upload provider configurations
• Notification settings
• Widget configuration

⚠️ Do not edit this file while CyberSnap is running. Changes may be overwritten.

---

History Database

File: history.db (SQLite)

Contains:

• Capture metadata (date, source, dimensions, file path)
• OCR-extracted text
• Barcode/QR scan results
• Color picker history
• Full-text search index

Database Schema Overview

Table	Content
captures	Capture metadata and file references
ocr_results	Extracted text and language info
barcodes	Decoded barcode/QR content
colors	Picked colors with timestamps
search_index	Full-text search index

Manual Querying

You can open history.db with any SQLite browser for advanced queries or data export.

---

Credentials Vault

File: vault.dat

Contains encrypted upload provider credentials:

• FTP/SFTP passwords and keys
• S3 access and secret keys
• API keys for ImgBB, Imgur, CyberSnap Share
• Webhook secrets

Security Details

• Algorithm: AES-256-GCM
• Key derivation: Machine-specific entropy
• No cloud sync: Vault never leaves your machine

⚠️ The vault is tied to your machine. Copying the vault file to another computer will not work.

---

Capture Files

Screenshots

Saved to the configured captures folder with automatic naming:

CyberSnap_YYYYMMDD_HHmmss.png

Recordings

Saved to the configured recordings folder:

Recording_YYYYMMDD_HHmmss.mp4
Recording_YYYYMMDD_HHmmss.gif

---

Custom Sounds

CyberSnap allows overriding default sounds with your own MP3 files.

Sound Files

Place MP3 files in the sounds folder with these names:

File	Event
capture.mp3	Capture taken
upload_success.mp3	Upload completed
upload_fail.mp3	Upload failed
ocr_complete.mp3	OCR finished
achievement.mp3	Achievement unlocked

Requirements

• Format: MP3
• Recommended: Under 5 seconds
• Sample rate: 44.1 kHz

---

Log Files

CyberSnap writes diagnostic logs for troubleshooting:

• log_YYYYMMDD.txt — Daily log files
• Automatically rotated (keeps last 7 days)
• Contains errors, warnings, and diagnostic info

Log Levels

Level	Description
Error	Critical issues requiring attention
Warning	Non-critical issues
Info	General operation logging
Debug	Detailed diagnostic info (if enabled)

---

Backing Up Your Data

To back up all CyberSnap data:

1. Close CyberSnap
2. Copy the entire %LOCALAPPDATA%\CyberSnap folder
3. (Optional) Copy your captures and recordings folders
4. Store the backup in a safe location

To restore:

1. Close CyberSnap
2. Replace the folder with your backup
3. Launch CyberSnap

---

Resetting Data

Reset Settings

Delete or rename settings.json. CyberSnap creates a new default file on next launch.

Reset History

Delete or rename history.db. CyberSnap creates a new empty database on next launch.

Full Reset

Delete the entire %LOCALAPPDATA%\CyberSnap folder. CyberSnap recreates all files with defaults on next launch.

⚠️ Full reset removes all settings, history, and credentials. Back up first if needed.