How brightwav3/winv works
WinV is a macOS clipboard-history app. Its main workflow is: a global shortcut opens the history panel, the user selects a saved clip, and WinV restores it to the clipboard and pastes into the previous app. Separately, a background watcher captures clipboard changes into persistent history. Settings configure shortcuts, appearance, and recording; the app also checks and installs signed updates. The graph reflects documented behavior and shown calls; some UI-to-rendering and paste wiring is documented but not visible in the sampled excerpts.
Main entry points: App.swift App lifecycle and menu · Store.swift History and settings · Panel.swift History panel · Windows.swift Settings and onboarding
Components 15
App and interaction
- App lifecycle and menu
Sources/WinV/App.swift - Global shortcuts
Sources/WinV/System.swift - History panel
Sources/WinV/Panel.swift - Paste dispatch
Sources/WinV/System.swift
Capture and history
- Clipboard capture
Sources/WinV/Store.swift - History and settings
Sources/WinV/Store.swift - History files
UI and appearance
- Settings and onboarding
Sources/WinV/Windows.swift - Glass surfaces
Sources/WinV/Glass.swift - Theme and styles
Sources/WinV/Theme.swift
Updates
- Update checker and installer
Sources/WinV/Updater.swift
Other components
- User
- macOS services
- Frontmost app
- GitHub Releases
Connections 23
- User → Global shortcuts: presses shortcut
README.md - Global shortcuts → History panel: opens panel
Sources/WinV/System.swift - User → History panel: selects clip
README.md - History panel → History and settings: uses history
Sources/WinV/Panel.swift - History panel → Paste dispatch: requests paste
- Paste dispatch → History and settings: restores clip
Sources/WinV/Store.swift - Paste dispatch → Frontmost app: sends paste
Sources/WinV/System.swift - Clipboard capture → macOS services: reads clipboard
README.md - Clipboard capture → History and settings: records clips
Sources/WinV/Store.swift - History and settings → History files: persists history
README.md - History and settings → macOS services: writes clipboard
Sources/WinV/Store.swift - App lifecycle and menu → Clipboard capture: starts watcher
Sources/WinV/App.swift - App lifecycle and menu → Global shortcuts: registers shortcut
Sources/WinV/App.swift - App lifecycle and menu → History and settings: syncs pins
Sources/WinV/App.swift - App lifecycle and menu → Settings and onboarding: opens onboarding
Sources/WinV/App.swift - App lifecycle and menu → Theme and styles: applies appearance
Sources/WinV/App.swift - User → Settings and onboarding: changes preferences
README.md - Settings and onboarding → Global shortcuts: sets shortcuts
Sources/WinV/Windows.swift - History panel → Glass surfaces: uses glass UI
README.md - Settings and onboarding → Glass surfaces: tunes glass
README.md - App lifecycle and menu → Update checker and installer: starts updates
Sources/WinV/App.swift - Update checker and installer → GitHub Releases: checks releases
Sources/WinV/Updater.swift - Update checker and installer → macOS services: notifies and installs
Sources/WinV/Updater.swift