How jahnzh/sonder works
Sonder is a self-hosted audiobook and ebook library PWA. Users browse or discover works, acquire media, then listen or read; reader positions can be synchronized with audiobook narration through CTC alignment. The server also manages library metadata, Hardcover integration, background work, and backups. The graph preserves documented alignment and backup capabilities despite limited excerpts; those branches use supported directory paths where implementation details were not sampled. Edges are limited to explicit imports, calls, README statements, or directly shown frontend data access; unsampled subsystem wiring is omitted.
Main entry points: app.ts HTTP application · App.tsx Application shell · acquisitions.ts Media acquisition · lib.ts Client API and storage
Components 24
PWA experience
- Reader
src/components/Reader.tsx - Audiobook player
src/player.tsx - Client API and storage
src/lib.ts - Navigation
src/navigation.ts - Application shell
src/App.tsx
Library and acquisition
- Media acquisition
server/acquisitions.ts - Library and discovery
src/pages - Hardcover sync
server/hardcover.ts - Series acquisition
server/series-acquisition.ts
Reading synchronization
- Alignment orchestration
server/alignment.ts - CTC alignment pipeline
worker/ctc_pipeline.py - Remote worker pool
server/alignment-pool.ts - Reading sync UI
src/pages/reading-sync-model.ts
Server platform
- HTTP application
server/app.ts - SQLite database
server/db.ts - Data schema
server/schema.ts - Background jobs
server/background-runner.ts - Database backups
server/backups.ts - Media storage
server/storage.ts - Accounts and access
server/users.ts
External services
- Hardcover API
- TorBox
- Transmission
Other components
- Reader
Connections 26
- Reader → Application shell: uses
README.md - Application shell → Navigation: routes through
src/App.tsx - Application shell → Client API and storage: calls API
src/App.tsx - Reader → Client API and storage: saves position
src/components/Reader.tsx - Audiobook player → Client API and storage: loads media
src/player.tsx - Application shell → Reader: renders
src/App.tsx - Application shell → Audiobook player: renders
src/App.tsx - Client API and storage → HTTP application: requests
- HTTP application → Media acquisition: routes acquisition
server/app.ts - HTTP application → Hardcover sync: routes sync
server/app.ts - Hardcover sync → Hardcover API: syncs metadata
- HTTP application → Series acquisition: routes series
server/app.ts - HTTP application → Alignment orchestration: routes alignment
server/app.ts - Alignment orchestration → Remote worker pool: dispatches jobs
- Remote worker pool → CTC alignment pipeline: runs alignment
- Reading sync UI → Client API and storage: loads sync state
- Media acquisition → TorBox: checks cached media
server/acquisitions.ts - Media acquisition → Transmission: queues torrents
server/acquisitions.ts - Media acquisition → Media storage: resolves files
server/acquisitions.ts - HTTP application → Accounts and access: authenticates
server/app.ts - HTTP application → SQLite database: uses database
server/app.ts - HTTP application → Data schema: uses schema
server/app.ts - Hardcover sync → SQLite database: reads and writes
server/hardcover.ts - Media acquisition → SQLite database: updates status
server/acquisitions.ts - Database backups → SQLite database: backs up
README.md - Background jobs → Database backups: schedules
README.md