How listenupapp/listenup works
ListenUp is a self-hosted audiobook platform: users connect Android, iOS, or browser clients to their own server to browse a library, play or download books, and keep listening progress synchronized across devices. The server also hosts the web client and transcodes formats browsers cannot play. The graph reflects README-documented workflows and sampled sync, playback, authentication, and transcode internals; several feature areas are represented at their exact enclosing directories because their implementation files were not sampled.
Main entry points: src Native apps · ListenUp iOS app · server ListenUp server · web Web client
Components 22
Client apps
- Native apps
app/sharedUI/src - iOS app
app/iosApp/ListenUp - Web client
app/webApp/src/jsMain/kotlin/com/calypsan/listenup/web - Audio playback
app/iosApp/ListenUp/Features/Player/AudioEngine.swift - Android playback service
app/sharedUI/src/androidMain/kotlin/com/calypsan/listenup/client/playback/PlaybackService.kt
Shared client core
- Sync engine
app/sharedLogic/src/commonMain/kotlin/com/calypsan/listenup/client/data/sync - Offline library store
app/sharedLogic/src/commonMain/kotlin/com/calypsan/listenup/client/data/local/db - Book downloads
app/sharedLogic/src/commonMain/kotlin/com/calypsan/listenup/client/download
Server platform
- ListenUp server
server/src/commonMain/kotlin/com/calypsan/listenup/server - Session service
server/src/commonMain/kotlin/com/calypsan/listenup/server/auth/SessionService.kt - Change event bus
server/src/commonMain/kotlin/com/calypsan/listenup/server/sync/ChangeBus.kt - Media transcoding
server/src/commonMain/kotlin/com/calypsan/listenup/server/transcode/TranscodeSessionEngine.kt
Shared contract
- Authentication contract
contract/src/commonMain/kotlin/com/calypsan/listenup/api/AuthService.kt - Secure credentials
contract/src/commonMain/kotlin/com/calypsan/listenup/core/SecureStorage.kt - Sync messages
contract/src/commonMain/kotlin/com/calypsan/listenup/api/sync/SyncFrame.kt
Library features
- Library catalog
server/src/commonMain/kotlin/com/calypsan/listenup/server/services - Catalog discovery
app/iosApp/ListenUp/Features/Discover - Document reader
app/iosApp/ListenUp/Features/DocumentReader - Library administration
app/iosApp/ListenUp/Features/Admin - Social listening
app/iosApp/ListenUp/Features/Discover
Other components
- Listener
- User server
Connections 33
- Listener → Native apps: uses
- Listener → iOS app: uses
- Listener → Web client: uses
- Native apps → ListenUp server: connects to
- iOS app → ListenUp server: connects to
- Web client → ListenUp server: served by
- Native apps → Audio playback: plays audio
- iOS app → Audio playback: plays audio
app/iosApp/ListenUp/Features/Player/AudioEngine.swift - Android playback service → Audio playback: plays audio
- Native apps → Book downloads: downloads books
- iOS app → Book downloads: downloads books
- Book downloads → Offline library store: stores offline
app/sharedLogic/src/appleMain/kotlin/com/calypsan/listenup/client/download/AppleDownloadService.kt - Sync engine → Offline library store: uses local state
app/sharedLogic/src/commonMain/kotlin/com/calypsan/listenup/client/data/sync/PendingOperationQueue.kt - Sync engine → Sync messages: exchanges frames
app/sharedLogic/src/commonMain/kotlin/com/calypsan/listenup/client/data/sync/SyncEventDispatcher.kt - Sync engine → ListenUp server: syncs progress
- Change event bus → Sync engine: delivers live changes
- Native apps → Authentication contract: authenticates via
- iOS app → Authentication contract: authenticates via
- Session service → Authentication contract: implements sessions
- Authentication contract → Secure credentials: stores credentials
- ListenUp server → Library catalog: serves library
server/src/commonMain/kotlin/com/calypsan/listenup/server/services/CoverSearchService.kt - Native apps → Catalog discovery: browses catalog
- iOS app → Catalog discovery: browses catalog
- Web client → Catalog discovery: browses catalog
- Web client → Media transcoding: requests playable media
- ListenUp server → Media transcoding: transcodes formats
server/src/commonMain/kotlin/com/calypsan/listenup/server/transcode/TranscodeSessionEngine.kt - Native apps → Document reader: reads supplements
- iOS app → Document reader: reads supplements
- Native apps → Library administration: manages library
- iOS app → Library administration: manages library
- Native apps → Social listening: views activity
- iOS app → Social listening: views activity
- User server → ListenUp server: hosts