How 1of1adam/droppy works
Droppy is a native macOS productivity app centered on a notch-style shelf, with floating baskets, clipboard history, HUDs, and installable extensions. The primary workflow is to drop or capture items, manage them in the shelf or a basket, then use actions such as sharing, conversion, or OCR. The graph combines documented capabilities with relationships visible in the supplied source index and excerpts; unsampled implementation details are represented only at supported directory level.
Main entry points: NotchWindowController.swift Notch controller · FloatingBasketWindowController.swift Floating baskets · ClipboardManagerView.swift Clipboard viewer · MusicManager.swift Now playing
Components 24
Shelf and baskets
- Notch controller
Droppy/NotchWindowController.swift - File shelf
Droppy/NotchShelfView.swift - Shelf state
Droppy/DroppyState.swift - Drag monitor
Droppy/DragMonitor.swift - Floating baskets
Droppy/FloatingBasketWindowController.swift - Basket state
Droppy/BasketState.swift
Content tools
- File items
Droppy/DroppedItem.swift - Clipboard history
Droppy/ClipboardManager.swift - Clipboard viewer
Droppy/ClipboardManagerView.swift - Quickshare
Droppy/QuickshareManager.swift - File conversion
Droppy/FileConverter.swift - OCR service
Droppy/OCRService.swift
System overlays
- HUD manager
Droppy/HUDManager.swift - Now playing
Droppy/MusicManager.swift - Spotify controls
Droppy/SpotifyController.swift - Apple Music controls
Droppy/Extensions/AppleMusic/AppleMusicController.swift
Extensions
- Productivity extensions
Droppy/Extensions - Reminders and tasks
Droppy/Extensions/ToDo/ToDoManager.swift - Element capture
Droppy/Extensions/ElementCapture/ElementCaptureManager.swift
Shared foundations
- Global shortcuts
Droppy/GlobalHotKey.swift - Permission manager
Droppy/PermissionManager.swift - Temporary files
Droppy/TemporaryFileStorageService.swift - Analytics service
Droppy/AnalyticsService.swift
Other components
- Mac user
Connections 27
- Mac user → Notch controller: opens notch
README.md - Notch controller → File shelf: shows shelf
Droppy/NotchWindowController.swift - Notch controller → Shelf state: reads state
Droppy/NotchWindowController.swift - Mac user → File shelf: drops files
README.md - File shelf → Shelf state: manages items
- Shelf state → File items: stores items
Droppy/DroppyState.swift - Mac user → Drag monitor: drags items
README.md - Drag monitor → Floating baskets: spawns basket
Droppy/DragMonitor.swift - Floating baskets → Basket state: manages contents
Droppy/FloatingBasketWindowController.swift - Floating baskets → File items: displays items
Droppy/FloatingBasketWindowController.swift - File items → Temporary files: creates temporary files
Droppy/DroppedItem.swift - Mac user → Clipboard viewer: searches history
README.md - Clipboard viewer → Clipboard history: uses history
Droppy/ClipboardManagerView.swift - Clipboard history → Permission manager: checks access
Droppy/ClipboardManager.swift - Clipboard viewer → OCR service: requests OCR
Droppy/ClipboardManagerView.swift - Mac user → Quickshare: shares files
README.md - Mac user → File conversion: converts files
README.md - Notch controller → HUD manager: shows overlays
Droppy/NotchWindowController.swift - Notch controller → Now playing: reads playback
Droppy/NotchWindowController.swift - Now playing → Spotify controls: controls playback
Droppy/MusicManager.swift - Now playing → Apple Music controls: controls playback
Droppy/MusicManager.swift - Mac user → Productivity extensions: installs extensions
README.md - Mac user → Reminders and tasks: captures tasks
README.md - Mac user → Element capture: captures elements
README.md - Element capture → Global shortcuts: registers shortcuts
Droppy/Extensions/ElementCapture/ElementCaptureManager.swift - Global shortcuts → Permission manager: checks access
Droppy/GlobalHotKey.swift - Productivity extensions → Analytics service: tracks activation
Droppy/Extensions/AIBackgroundRemoval/AIInstallManager.swift