FolderSnap is a secure, 100% offline Android camera application designed for systematic document scanning, receipt archiving, and structural photo categorization. It allows users to launch the camera directly inside specific nested directories, organizing photos instantly on capture without cluttering the system gallery.
- 📂 Nested Directory Structure: Create, rename, move, and recursively delete multi-level directories to organize captured images systematically.
- 🔒 100% Local & Secure: No internet permission requested. All image files and Room database metadata are kept strictly on-device.
- 🏷️ Photo Annotation & Filtering: Annotate captured files with multi-value tags, star ratings, and text comments. Filter through your archive with high-precision compound criteria.
- 📝 Scoped Storage Renaming: Rename individual photos physically with automatic parent folder prefixes while strictly complying with modern Android Scoped Storage guidelines.
- 🚀 Advanced Shutter & Zoom Control:
- Volume Key Shutter: Intercepts hardware volume up/down presses to trigger capture, minimizing hand shakes.
- Viewfinder zoom: Pinch-to-zoom gestures and quick preset buttons (
1x,2x,4x,8x). - Orientation-Adaptive Capture: Automatically maps accelerometer physical angles to target rotation EXIF data, preserving true horizontal/vertical output layouts.
- 💾 SAF JSON Backup: Export and import annotation metadata easily to/from local storage via Android Storage Access Framework (SAF).
- Android Studio (Koala or newer)
- JDK 17
Clone the repository and run the Gradle wrapper command:
./gradlew clean assembleDebugThe compiled debug APK will be generated at:
app/build/outputs/apk/debug/app-debug.apk