How xlr-aex/albatros works
Albatros is a local-first Electron feed reader. Users manage subscriptions, sync RSS/Atom/JSON Feed and Reddit content, then browse, search, save, and read downloaded articles; separate branches cover OPML exchange, GitHub views, and local Laya classification. The graph follows documented and excerpted wiring. Some UI capabilities are documented but their implementation was not sampled, so those branches are shown without speculative internal call edges.
Main entry points: index.ts Main process · SyncEngine.ts Feed sync · App.tsx Reader · feeds.ts Feed IPC
Components 25
Desktop interface
- Reader
src/renderer/src/App.tsx - Feed navigation
src/renderer/src/components/layout/Sidebar.tsx - Feed state
src/renderer/src/store/feedStore.ts - Article state
src/renderer/src/store/articleStore.ts - Article view
src/renderer/src/components/layout/ArticleReader.tsx
IPC and application
- Preload bridge
src/preload/index.ts - Main process
src/main/index.ts - Feed IPC
src/main/ipc/feeds.ts - Article IPC
src/main/ipc/articles.ts - Settings IPC
src/main/ipc/settings.ts - Laya IPC
src/main/ipc/laya.ts
Feeds and reading
- Local database
src/main/db/connection.ts - Feed management
src/main/services/FeedService.ts - Article operations
src/main/services/ArticleService.ts - Full-text search
src/main/services/SearchService.ts - OPML exchange
src/main/services/OpmlService.ts
Synchronization
- Sync scheduler
src/main/sync/Scheduler.ts - Feed sync
src/main/sync/SyncEngine.ts - HTTP client
src/main/sync/HttpClient.ts - Feed parser
src/main/sync/FeedParser.ts
Local features
- Settings
src/main/services/SettingsService.ts - Laya classifier
src/main/services/LayaService.ts - Laya runtime
src/main/services/LayaRuntimeService.ts
Other components
- Local Laya worker
- Reader
Connections 40
- Reader → Reader: uses
README.md - Reader → Feed navigation: renders
src/renderer/src/App.tsx - Reader → Feed state: loads feeds
src/renderer/src/App.tsx - Reader → Article state: loads articles
src/renderer/src/App.tsx - Reader → Article view: renders
src/renderer/src/App.tsx - Feed navigation → Feed state: updates
src/renderer/src/components/layout/Sidebar.tsx - Feed state → Preload bridge: calls API
src/renderer/src/store/feedStore.ts - Article state → Preload bridge: calls API
src/renderer/src/store/articleStore.ts - Article view → Article state: reads state
src/renderer/src/components/layout/ArticleReader.tsx - Preload bridge → Feed IPC: routes calls
src/preload/index.ts - Preload bridge → Article IPC: routes calls
src/preload/index.ts - Main process → Feed IPC: registers
src/main/index.ts - Main process → Article IPC: registers
src/main/index.ts - Main process → Settings IPC: registers
src/main/index.ts - Main process → Laya IPC: registers
src/main/index.ts - Feed IPC → Feed management: calls
src/main/ipc/feeds.ts - Feed IPC → OPML exchange: calls
src/main/ipc/feeds.ts - Feed IPC → Sync scheduler: triggers
src/main/ipc/feeds.ts - Article IPC → Article operations: calls
src/main/ipc/articles.ts - Article IPC → Full-text search: calls
src/main/ipc/articles.ts - Settings IPC → Settings: calls
src/main/ipc/settings.ts - Laya IPC → Laya classifier: calls
src/main/ipc/laya.ts - Main process → Local database: opens
src/main/index.ts - Main process → Feed management: creates
src/main/index.ts - Main process → Article operations: creates
src/main/index.ts - Main process → Full-text search: creates
src/main/index.ts - Main process → Settings: creates
src/main/index.ts - Main process → OPML exchange: creates
src/main/index.ts - Main process → Feed sync: creates
src/main/index.ts - Main process → Sync scheduler: creates
src/main/index.ts - Main process → Laya classifier: starts
src/main/index.ts - Sync scheduler → Feed sync: schedules
src/main/sync/Scheduler.ts - Feed sync → HTTP client: fetches via
src/main/sync/SyncEngine.ts - Feed sync → Feed parser: parses via
src/main/sync/SyncEngine.ts - Feed sync → Feed management: reads feeds
src/main/sync/SyncEngine.ts - Feed sync → Article operations: upserts articles
src/main/sync/SyncEngine.ts - Feed sync → Local database: persists batch
src/main/sync/SyncEngine.ts - Laya classifier → Laya runtime: uses
src/main/services/LayaService.ts - Laya classifier → Local Laya worker: classifies via HTTP
src/main/services/LayaService.ts - Laya IPC → Settings IPC