How eddie-dk1/threadgoon works
Threadgoon is a macOS thread-search and attachment-download application, with a supported terminal interface. The main workflow is search 4chan catalogs, optionally inspect threads and attachments for exact matches, confirm a download set, then queue and resume downloads; users can also monitor threads for new files. The graph includes the SwiftUI client, Python engine, shared persistence and configuration, plus the documented watch and terminal capabilities. Source excerpts are partial, so uncertain internal links are omitted; README statements support the cross-process relationship.
Main entry points: database.py Workspace database · controller.py Command controller · ContentView.swift SwiftUI window · watcher.py Thread watcher
Components 24
macOS application
- SwiftUI window
native/Sources/Threadgoon/ContentView.swift - UI state
native/Sources/Threadgoon/AppModel.swift - Engine process client
native/Sources/Threadgoon/EngineClient.swift - Thread thumbnails
native/Sources/Threadgoon/ThumbnailView.swift - Queue views
native/Sources/Threadgoon/QueueViews.swift - Utility views
native/Sources/Threadgoon/UtilityViews.swift - Wire models
native/Sources/ThreadgoonCore/Models.swift
Python engine
- Engine protocol
threadgoon/bridge.py - Command controller
threadgoon/controller.py - Catalog and thread scan
threadgoon/scanner.py - 4chan API client
threadgoon/api.py - Download manager
threadgoon/downloader.py - Thread watcher
threadgoon/watcher.py - Preview helpers
threadgoon/preview.py
Workspace data
- Workspace database
threadgoon/database.py - Application settings
threadgoon/config.py - Workspace paths
threadgoon/paths.py - Domain records
threadgoon/models.py - Logging setup
threadgoon/logging_config.py
Terminal interface
- Terminal interface
threadgoon/app.py - Terminal commands
threadgoon/cli.py
Other components
- User
- 4chan service
- Workspace files
Connections 36
- User → SwiftUI window: uses
README.md - SwiftUI window → UI state: displays state
native/Sources/Threadgoon/ContentView.swift - SwiftUI window → Thread thumbnails: renders
native/Sources/Threadgoon/ContentView.swift - SwiftUI window → Queue views: renders
native/Sources/Threadgoon/QueueViews.swift - SwiftUI window → Utility views: renders
native/Sources/Threadgoon/UtilityViews.swift - UI state → Engine process client: sends commands
native/Sources/Threadgoon/AppModel.swift - Engine process client → Engine protocol: starts Python engine
README.md - Engine process client → Wire models: frames messages
native/Sources/Threadgoon/EngineClient.swift - Engine protocol → Command controller: dispatches commands
threadgoon/bridge.py - Command controller → Catalog and thread scan: runs searches
threadgoon/controller.py - Command controller → Download manager: controls jobs
threadgoon/controller.py - Command controller → Thread watcher: manages watches
threadgoon/controller.py - Catalog and thread scan → 4chan API client: fetches metadata
threadgoon/scanner.py - Catalog and thread scan → Workspace database: reads and stores scans
threadgoon/scanner.py - 4chan API client → 4chan service: requests JSON API
README.md - 4chan API client → Workspace database: caches responses
threadgoon/api.py - Download manager → Workspace database: updates jobs
threadgoon/downloader.py - Download manager → 4chan service: fetches media
threadgoon/downloader.py - Download manager → Workspace files: writes files
README.md - Thread watcher → 4chan API client: polls threads
threadgoon/watcher.py - Thread watcher → Workspace database: updates watches
threadgoon/watcher.py - Thread watcher → Download manager: queues new files
threadgoon/watcher.py - Thread watcher → Catalog and thread scan: parses threads
threadgoon/watcher.py - Preview helpers → Catalog and thread scan: uses scan records
threadgoon/preview.py - Command controller → Application settings: uses settings
threadgoon/controller.py - Application settings → Workspace paths: validates workspace
threadgoon/config.py - Command controller → Workspace database: reads and writes state
threadgoon/controller.py - Workspace database → Domain records: stores records
threadgoon/database.py - Workspace database → Workspace files: persists SQLite and cache
README.md - Workspace paths → Workspace files: validates locations
threadgoon/paths.py - User → Terminal commands: runs commands
README.md - Terminal commands → Terminal interface: opens interface
threadgoon/cli.py - Terminal interface → Command controller: submits operations
threadgoon/app.py - Terminal interface → Workspace database: shows history
threadgoon/app.py - Terminal commands → Application settings: loads settings
threadgoon/cli.py - Terminal commands → Logging setup: configures logs
threadgoon/cli.py