Skip to content

markksantos/DesktopRecord

Repository files navigation

🖥️ DesktopRecord

DesktopRecord icon

macOS app that continuously captures your screen activity with OCR-powered search and analytics

Swift SwiftUI macOS

Features · Getting Started · Tech Stack

Download DMG


Timeline View

Settings


✨ Features

  • Continuous Screen Capture — Automatically records screenshots of your desktop activity throughout the day
  • OCR-Powered Search — Full-text search across all captured screens using Apple Vision framework for accurate text recognition
  • Timeline View — Browse your activity chronologically with an interactive timeline interface
  • App Analytics — Pie charts and weekly trend views showing how you spend time across applications
  • Active App Tracking — Detects the frontmost application and window title via Accessibility APIs
  • Privacy Controls — Built-in privacy manager to exclude specific apps or time periods
  • Data Retention — Configurable retention policies to automatically clean up old captures
  • Menu Bar Access — Quick access from the macOS menu bar

🚀 Getting Started

Prerequisites

  • macOS 14.0+
  • Xcode 15+
  • Screen Recording & Accessibility permissions

Installation

git clone https://github.com/your-username/DesktopRecord.git
cd DesktopRecord

Open DesktopRecord.xcodeproj in Xcode and build (⌘B), or generate the project with XcodeGen:

xcodegen generate
open DesktopRecord.xcodeproj

🛠️ Tech Stack

Category Technology
Language Swift 5.9
UI SwiftUI
OCR Apple Vision Framework
Database SQLite
Build XcodeGen (project.yml)
Platform macOS 14.0+

📁 Project Structure

DesktopRecord/
├── DesktopRecord/
│   ├── Models/           # Data models (AppInfo)
│   ├── Services/         # Core services
│   │   ├── ActiveAppTracker.swift
│   │   ├── OCRService.swift
│   │   ├── SearchEngine.swift
│   │   ├── AnalyticsService.swift
│   │   ├── StorageManager.swift
│   │   ├── PrivacyManager.swift
│   │   └── RetentionManager.swift
│   ├── ViewModels/       # View models
│   ├── Views/            # SwiftUI views
│   │   ├── ContentView.swift
│   │   ├── Timeline/
│   │   ├── Search/
│   │   ├── Analytics/
│   │   └── MenuBar/
│   └── Utilities/        # Constants & helpers
├── project.yml           # XcodeGen configuration
└── DerivedData/

📄 License

MIT License © 2025 Mark Santos

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages