Skip to content

LamonJ/ScreenshotGuardian

Repository files navigation

Screenshot Guardian

A comprehensive iOS app for managing screenshots with AI-powered sensitive information detection and privacy protection.

Features

πŸ” Screenshot Detection & Management

  • Automatically identifies screenshots in your photo library
  • Smart filtering and organization
  • Thumbnail generation for quick preview
  • Batch operations for efficient management

πŸ€– AI-Powered Analysis

  • Local AI Processing: All analysis happens on-device using Apple's Vision framework
  • Text Recognition: Extracts and analyzes text content from screenshots
  • Sensitive Content Detection: Identifies personal information, financial data, medical records, and more
  • Pattern Matching: Detects SSNs, credit cards, emails, addresses, and other sensitive patterns
  • Sensitivity Scoring: Provides detailed risk assessment for each screenshot

πŸ›‘οΈ Privacy & Security

  • 100% Local Processing: No data leaves your device
  • No Cloud Dependencies: Complete privacy protection
  • Secure Deletion: Permanent removal from photo library
  • User Control: Full control over what gets analyzed and deleted

πŸ“± User Interface

  • Modern SwiftUI Design: Clean, intuitive interface
  • Tab Navigation: Easy access to screenshots and settings
  • Filtering Options: View sensitive content only or marked for deletion
  • Detailed Analysis: Comprehensive breakdown of detected sensitive content
  • Progress Tracking: Real-time analysis progress

Screenshots

Main Features

  • Screenshot List: View all detected screenshots with AI analysis status
  • Detail View: Comprehensive analysis results and management options
  • Settings: Configure AI sensitivity, auto-analysis, and privacy settings
  • Batch Operations: Analyze or delete multiple screenshots at once

Technical Architecture

Core Components

ScreenshotManager

  • Handles photo library access and permissions
  • Manages screenshot detection and loading
  • Provides filtering and batch operations
  • Handles thumbnail generation and caching

AIScanner

  • Implements Vision framework for text recognition
  • Performs local pattern matching for sensitive content
  • Provides sensitivity scoring and content classification
  • Supports batch analysis with progress tracking

Data Models

  • Screenshot: Core data model with analysis results
  • AIAnalysisResult: Encapsulates AI analysis findings
  • Comprehensive status tracking and user actions

AI Analysis Capabilities

Detected Content Types

  • Personal Information: SSNs, driver's licenses, passports
  • Financial Data: Credit cards, bank accounts, payment information
  • Medical Records: Diagnoses, prescriptions, patient information
  • Legal Documents: Court cases, legal correspondence
  • Addresses: Physical addresses and location data
  • Credentials: Passwords, tokens, access codes

Pattern Recognition

  • Regular expression matching for structured data
  • Keyword detection for sensitive terms
  • Length-based analysis for potential credentials
  • Context-aware scoring system

Installation & Setup

Requirements

  • iOS 17.0+
  • Xcode 15.0+
  • Photo Library access permission

Build Instructions

  1. Clone the repository
  2. Open ScreenshotGuardian.xcodeproj in Xcode
  3. Select your development team
  4. Build and run on device or simulator

Permissions Required

  • Photo Library Access: Required to detect and manage screenshots
  • Camera Access: Optional for enhanced screenshot detection

Usage Guide

Getting Started

  1. Launch the App: Open Screenshot Guardian
  2. Grant Permissions: Allow photo library access when prompted
  3. View Screenshots: Your screenshots will appear in the main list
  4. Run Analysis: Tap "Analyze All" to scan for sensitive content
  5. Review Results: Check analysis results in the detail view
  6. Manage Content: Mark sensitive screenshots for deletion

Analysis Process

  1. Text Extraction: AI extracts all text from screenshots
  2. Pattern Matching: Identifies sensitive patterns and keywords
  3. Scoring: Calculates sensitivity score (0-100%)
  4. Classification: Marks screenshots as sensitive if score > 50%
  5. Reporting: Provides detailed breakdown of detected content

Privacy Features

  • Local Processing: All analysis happens on your device
  • No Data Transmission: Nothing is sent to external servers
  • User Control: You decide what gets analyzed and deleted
  • Secure Storage: Analysis results stored locally only

Configuration Options

AI Analysis Settings

  • Auto-Analysis: Automatically analyze new screenshots
  • Sensitivity Threshold: Adjust detection sensitivity (10-100%)
  • Notifications: Get alerts for sensitive content detection
  • Auto-Deletion: Automatically delete high-sensitivity screenshots

Privacy Settings

  • Data Export: Export analysis results (local only)
  • Settings Reset: Clear all app data and settings
  • Access Control: Manage photo library permissions

Security & Privacy

Data Protection

  • Local Storage: All data stored on device only
  • No Network Access: App operates completely offline
  • Secure Deletion: Permanent removal from photo library
  • Privacy First: No telemetry or analytics collection

AI Processing

  • Apple Vision Framework: Uses native iOS text recognition
  • Local Pattern Matching: Custom algorithms run on-device
  • No External APIs: No reliance on cloud AI services
  • Transparent Processing: Clear explanation of analysis results

Development

Project Structure

ScreenshotGuardian/
β”œβ”€β”€ ScreenshotGuardianApp.swift      # App entry point
β”œβ”€β”€ ContentView.swift                # Main tab navigation
β”œβ”€β”€ Views/
β”‚   β”œβ”€β”€ ScreenshotListView.swift    # Main screenshot list
β”‚   β”œβ”€β”€ ScreenshotDetailView.swift  # Individual screenshot details
β”‚   └── SettingsView.swift          # App settings
β”œβ”€β”€ Models/
β”‚   └── Screenshot.swift            # Data models
β”œβ”€β”€ Managers/
β”‚   β”œβ”€β”€ ScreenshotManager.swift     # Photo library management
β”‚   └── AIScanner.swift            # AI analysis engine
└── Assets.xcassets/               # App assets

Key Technologies

  • SwiftUI: Modern declarative UI framework
  • Photos Framework: Photo library access and management
  • Vision Framework: Text recognition and analysis
  • Combine: Reactive programming for data flow
  • Core Data: Local data persistence (future enhancement)

Future Enhancements

Planned Features

  • Cloud Sync: Optional iCloud integration for settings
  • Advanced AI: Machine learning for improved detection
  • Export Options: Share analysis reports
  • Automation: Background processing and notifications
  • Custom Patterns: User-defined sensitive content patterns

Technical Improvements

  • Performance: Optimized batch processing
  • Accuracy: Enhanced pattern recognition
  • UI/UX: Improved accessibility and design
  • Testing: Comprehensive unit and UI tests

Contributing

Development Guidelines

  • Follow SwiftUI best practices
  • Maintain privacy-first approach
  • Add comprehensive documentation
  • Include unit tests for new features
  • Ensure accessibility compliance

Code Style

  • Use Swift 5.0+ features
  • Follow Apple's Human Interface Guidelines
  • Implement proper error handling
  • Maintain clean architecture patterns

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For questions, issues, or feature requests, please open an issue on the project repository.


Screenshot Guardian: Protecting your privacy, one screenshot at a time. πŸ“±πŸ›‘οΈ

About

iOS app that manages screenshots with AI-powered sensitive content detection

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages