How jergensturdley/explorerr works
Explorerr is a native macOS file explorer. Its main workflow is navigating folders and search results in tabs and panes, viewing and selecting items, then opening or managing them. The graph also preserves the documented file-management, special-location, visual, persistence, and integrated-terminal capabilities. Source excerpts and the SOURCE INDEX support the core wiring; README-documented capabilities are included where implementation details were not sampled.
Main entry points: MainWindow.swift Window composition · TabState.swift Tab navigation state · AppModel.swift Shared app state · FileOps.swift File operations
Components 26
Application shell
- App entry
Sources/Explorerr/App/ExplorerrApp.swift - Window composition
Sources/Explorerr/App/MainWindow.swift - Commands and shortcuts
Sources/Explorerr/App/Commands.swift - Shared app state
Sources/Explorerr/Core/AppModel.swift - Pane and window state
Sources/Explorerr/Core/WindowModel.swift - Preferences and sessions
Sources/Explorerr/Core/Persistence.swift
Navigation and views
- Explorer chrome
Sources/Explorerr/Chrome/WindowChrome.swift - Address and search
Sources/Explorerr/Chrome/AddressBar.swift - Tab navigation state
Sources/Explorerr/Core/TabState.swift - Tab strip
Sources/Explorerr/Chrome/TabStrip.swift - Navigation pane
Sources/Explorerr/Views/NavigationPane.swift - Folder content router
Sources/Explorerr/Views/FolderContentView.swift - Folder presentations
Sources/Explorerr/Views/FolderViews.swift - Home, gallery, trash
Sources/Explorerr/Views/SpecialViews.swift - Details and properties
Sources/Explorerr/Views/DetailsPaneView.swift - Quick Look preview
Sources/Explorerr/Chrome/QuickLook.swift
Filesystem operations
- Directory and search
Sources/Explorerr/Core/DirectoryLoader.swift - File operations
Sources/Explorerr/Core/FileOps.swift - Disk access
Sources/Explorerr/Core/DiskAccess.swift
Integrated terminal
- Terminal panel
Sources/Explorerr/Views/TerminalPanelView.swift - Terminal controller
Sources/Explorerr/Core/TerminalController.swift - Terminal emulator
Sources/Explorerr/Core/TerminalEmulator.swift - PTY process
Sources/Explorerr/Core/PtyProcess.swift
Other components
- Explorer user
- macOS filesystem
- Login shell
Connections 36
- Explorer user → App entry: launches
README.md - App entry → Window composition: shows
Sources/Explorerr/App/ExplorerrApp.swift - Window composition → Pane and window state: composes
Sources/Explorerr/App/MainWindow.swift - Window composition → Folder content router: shows
Sources/Explorerr/App/MainWindow.swift - Window composition → Navigation pane: shows
Sources/Explorerr/App/MainWindow.swift - Window composition → Terminal panel: shows
Sources/Explorerr/App/MainWindow.swift - Window composition → Details and properties: shows
Sources/Explorerr/App/MainWindow.swift - Window composition → Explorer chrome: frames
- Explorer user → Commands and shortcuts: invokes
Sources/Explorerr/App/Commands.swift - Commands and shortcuts → File operations: requests changes
Sources/Explorerr/App/Commands.swift - Commands and shortcuts → Tab navigation state: reads active tab
Sources/Explorerr/App/Commands.swift - Address and search → Tab navigation state: navigates
Sources/Explorerr/Chrome/AddressBar.swift - Address and search → File operations: opens files
Sources/Explorerr/Chrome/AddressBar.swift - Tab strip → Tab navigation state: switches tabs
Sources/Explorerr/Chrome/TabStrip.swift - Tab navigation state → Directory and search: loads and searches
Sources/Explorerr/Core/TabState.swift - Tab navigation state → Shared app state: updates shared state
Sources/Explorerr/Core/TabState.swift - Folder content router → Tab navigation state: reads selection
Sources/Explorerr/Views/FolderContentView.swift - Folder content router → File operations: transfers items
Sources/Explorerr/Views/FolderContentView.swift - Folder content router → Folder presentations: renders listings
Sources/Explorerr/Views/FolderContentView.swift - Navigation pane → Tab navigation state: navigates locations
Sources/Explorerr/Views/NavigationPane.swift - Navigation pane → Home, gallery, trash: offers locations
- Details and properties → Quick Look preview: previews items
Sources/Explorerr/Views/DetailsPaneView.swift - Home, gallery, trash → Directory and search: reads locations
Sources/Explorerr/Views/SpecialViews.swift - Shared app state → Pane and window state: manages windows
Sources/Explorerr/Core/AppModel.swift - Shared app state → Directory and search: queries folders
Sources/Explorerr/Core/AppModel.swift - Shared app state → File operations: coordinates changes
Sources/Explorerr/Core/AppModel.swift - Shared app state → Preferences and sessions: saves state
Sources/Explorerr/Core/AppModel.swift - Pane and window state → Preferences and sessions: restores layout
Sources/Explorerr/Core/WindowModel.swift - Directory and search → macOS filesystem: enumerates and searches
Sources/Explorerr/Core/DirectoryLoader.swift - File operations → macOS filesystem: reads and mutates
Sources/Explorerr/Core/FileOps.swift - Disk access → macOS filesystem: accesses volumes
README.md - Terminal panel → Terminal controller: sends input
Sources/Explorerr/Views/TerminalPanelView.swift - Terminal controller → PTY process: starts and writes
Sources/Explorerr/Core/TerminalController.swift - Terminal controller → Terminal emulator: feeds output
Sources/Explorerr/Core/TerminalController.swift - PTY process → Login shell: runs
README.md - Window composition → Terminal controller: owns terminal
Sources/Explorerr/App/MainWindow.swift