How elizabeth-ling/otter works
Otter is a macOS menu-bar note-capture utility, not a notes app. The main workflow is a global hotkey opening a floating editor; submitting creates a durable capture in the outbox, then asynchronous delivery routes it to a configured destination and records recents. The README documents Obsidian and Apple Notes support, though their implementations are not in the supplied tree. Edges reflect sampled source, SOURCE INDEX references, or README statements; unsampled destination links are marked unverified.
Main entry points: DeliveryService.swift Delivery service · CaptureService.swift Capture service · PanelController.swift Panel controller · DestinationRegistry.swift Destination registry
Components 22
Capture interface
- Menu bar
App/MenuBar/StatusItemController.swift - Panel controller
App/Panel/PanelController.swift - Capture editor
App/Panel/PanelContentView.swift - Editor view
App/Panel/EditorView.swift - Panel placement
Packages/OtterCore/Sources/OtterCore/Panel/PanelPlacement.swift
Capture and delivery
- Draft persistence
Packages/OtterCore/Sources/OtterCore/Pipeline/DraftStore.swift - Capture service
App/Capture/CaptureService.swift - Capture model
Packages/OtterCore/Sources/OtterCore/Model/Capture.swift - Durable outbox
Packages/OtterCore/Sources/OtterCore/Pipeline/Outbox.swift - Delivery service
Packages/OtterCore/Sources/OtterCore/Pipeline/DeliveryService.swift - Recent captures
Packages/OtterCore/Sources/OtterCore/Pipeline/RecentStore.swift
Destinations
- Destination registry
Packages/OtterCore/Sources/OtterCore/Destinations/DestinationRegistry.swift - Destination interface
Packages/OtterCore/Sources/OtterCore/Destinations/Destination.swift - Folder destination
Packages/OtterCore/Sources/OtterCore/Destinations/Folder/FolderDestination.swift - Folder file helpers
Packages/OtterCore/Sources/OtterCore/Destinations/Folder/FileNamer.swift - Folder bookmarks
Packages/OtterCore/Sources/OtterCore/Destinations/Folder/FolderBookmark.swift - Folder chooser
App/MenuBar/FolderChooser.swift - Obsidian and Notes
Packages/OtterCore/Sources/OtterCore/Destinations
Hotkeys and state
- Global hotkeys
App/Hotkeys/HotkeyService.swift - Shortcut logic
Packages/OtterCore/Sources/OtterCore/Hotkeys/EffectiveToggleHotkey.swift - Hotkey settings
App/Hotkeys/HotkeyWindowController.swift
Other components
- User
Connections 26
- User → Global hotkeys: presses shortcut
App/Hotkeys/HotkeyService.swift - Global hotkeys → Shortcut logic: resolves shortcut
App/Hotkeys/HotkeyService.swift - Global hotkeys → Panel controller: toggles panel
App/AppDelegate.swift - Menu bar → Panel controller: opens panel
App/MenuBar/StatusItemController.swift - Menu bar → Folder chooser: opens chooser
App/MenuBar/StatusItemController.swift - Menu bar → Hotkey settings: opens settings
App/MenuBar/StatusItemController.swift - Panel controller → Capture editor: builds panel content
App/Panel/PanelController.swift - Capture editor → Editor view: renders editor
App/Panel/PanelContentView.swift - Panel controller → Panel placement: positions panel
App/Panel/PanelController.swift - Panel controller → Draft persistence: restores and saves
App/Panel/PanelController.swift - Capture editor → Capture service: submits note
- Capture service → Capture model: creates capture
App/Capture/CaptureService.swift - Capture service → Destination registry: selects destination
App/Capture/CaptureService.swift - Capture service → Durable outbox: journals capture
App/Capture/CaptureService.swift - Capture service → Delivery service: starts delivery
App/Capture/CaptureService.swift - Delivery service → Durable outbox: reads pending captures
Packages/OtterCore/Sources/OtterCore/Pipeline/DeliveryService.swift - Delivery service → Destination registry: looks up destination
App/Capture/CapturePipeline.swift - Delivery service → Recent captures: records delivery
Packages/OtterCore/Sources/OtterCore/Pipeline/DeliveryService.swift - Delivery service → Destination interface: delivers capture
Packages/OtterCore/Sources/OtterCore/Pipeline/DeliveryService.swift - Destination registry → Destination interface: builds destination
Packages/OtterCore/Sources/OtterCore/Destinations/DestinationRegistry.swift - Folder destination → Destination interface: implements
Packages/OtterCore/Sources/OtterCore/Destinations/Folder/FolderDestination.swift - Folder destination → Folder file helpers: names note files
Packages/OtterCore/Sources/OtterCore/Destinations/Folder/FolderDestination.swift - Folder destination → Folder bookmarks: resolves bookmark
Packages/OtterCore/Sources/OtterCore/Destinations/Folder/FolderDestination.swift - Folder chooser → Destination registry: updates folder config
App/MenuBar/FolderChooser.swift - Folder chooser → Delivery service: retries pending notes
App/MenuBar/FolderChooser.swift - Destination registry → Obsidian and Notes: supports documented backends
README.md