How sp201004/pastly works
Pastly is a native, local macOS clipboard manager. The main workflow observes clipboard changes, parses and filters copied content, stores clips, then presents searchable history for preview and paste back into the previously active app. The graph also covers settings, backup, privacy, migration, and the release-download website. Edges reflect README statements or source-index references and excerpts; unsampled implementation details are represented only at documented subsystem level.
Main entry points: ClipStore.swift Clip history · PanelController.swift Panel control · AppDelegate.swift App lifecycle · ClipboardCore.swift Clipboard monitor
Components 27
Capture and Core
- App lifecycle
Sources/Pastly/App/AppDelegate.swift - Clipboard monitor
Sources/Pastly/Core/ClipboardCore.swift - Clip parsing
Sources/Pastly/Core/ClipItemParser.swift - Capture privacy
Sources/Pastly/Core/CaptureFilter.swift - Duplicate detection
Sources/Pastly/Core/ContentHasher.swift - Media support
Sources/Pastly/Core/MediaSupport.swift
History and Data
- Clip history
Sources/Pastly/Data/ClipStore.swift - Local database
Sources/Pastly/Data/Database.swift - Image files
Sources/Pastly/Data/ImageStore.swift - Backup and restore
Sources/Pastly/Data/BackupService.swift - Legacy migration
Sources/Pastly/Core/LegacyMigration.swift
Clipboard Experience
- Panel control
Sources/Pastly/UI/PanelController.swift - History and lists
Sources/Pastly/UI/PanelView.swift - Clip preview
Sources/Pastly/UI/ItemViews.swift - Paste queue
Sources/Pastly/Core/PasteQueue.swift - User feedback
Sources/Pastly/UI/Feedback.swift
Settings and Privacy
- Preferences
Sources/Pastly/Core/Preferences.swift - System services
Sources/Pastly/Core/Services.swift - Settings actions
Sources/Pastly/Core/SettingsServices.swift - Settings screens
Sources/Pastly/UI/SettingsTabs.swift - Settings window
Sources/Pastly/UI/SettingsView.swift
Release Website
- Release website
website/main.js - Release API
website/api/_release.js
Other components
- Mac user
- Other macOS apps
- Download visitor
- GitHub Releases
Connections 33
- Mac user → App lifecycle: launches
Sources/Pastly/App/AppDelegate.swift - App lifecycle → Clipboard monitor: starts monitoring
Sources/Pastly/App/AppDelegate.swift - Other macOS apps → Clipboard monitor: copies content
README.md - Clipboard monitor → Clip parsing: parses contents
Sources/Pastly/Core/ClipboardCore.swift - Clipboard monitor → Capture privacy: checks capture
Sources/Pastly/Core/ClipboardCore.swift - Clipboard monitor → Clip history: ingests clips
Sources/Pastly/Core/ClipboardCore.swift - Clip parsing → Duplicate detection: hashes content
Sources/Pastly/Core/ClipItemParser.swift - Clip history → Local database: persists records
Sources/Pastly/Data/ClipStore.swift - Clip history → Image files: stores images
Sources/Pastly/Data/ClipStore.swift - App lifecycle → Legacy migration: migrates history
Sources/Pastly/App/AppDelegate.swift - Mac user → Panel control: opens history
README.md - App lifecycle → Panel control: creates panel
Sources/Pastly/App/AppDelegate.swift - Panel control → History and lists: presents view
Sources/Pastly/UI/PanelController.swift - History and lists → Clip history: shows history
Sources/Pastly/UI/PanelView.swift - History and lists → Clip preview: renders clips
Sources/Pastly/UI/PanelView.swift - Panel control → Clip history: manages selection
Sources/Pastly/UI/PanelController.swift - Panel control → Paste queue: queues paste
Sources/Pastly/UI/PanelController.swift - Paste queue → Clip history: marks use
Sources/Pastly/Core/PasteQueue.swift - Paste queue → User feedback: signals paste
Sources/Pastly/Core/PasteQueue.swift - Panel control → User feedback: signals actions
Sources/Pastly/UI/PanelController.swift - Paste queue → Other macOS apps: pastes content
README.md - Mac user → Settings window: configures app
README.md - Settings window → Settings screens: shows sections
Sources/Pastly/UI/SettingsView.swift - Settings screens → Preferences: edits preferences
Sources/Pastly/UI/SettingsTabs.swift - Settings screens → Settings actions: runs actions
Sources/Pastly/UI/SettingsTabs.swift - Settings actions → Backup and restore: exports imports
Sources/Pastly/Core/SettingsServices.swift - Backup and restore → Clip history: reads and restores
Sources/Pastly/Data/BackupService.swift - Settings actions → Clip history: manages history
Sources/Pastly/Core/SettingsServices.swift - System services → Preferences: reads settings
Sources/Pastly/Core/Services.swift - App lifecycle → Preferences: loads settings
Sources/Pastly/App/AppDelegate.swift - Mac user → Release website: visits
README.md - Release website → Release API: requests releases
- Release API → GitHub Releases: reads release assets
website/api/_release.js