How juananzzz/resonus works
Resonus is a mobile music player for self-hosted servers and local files. Users sign into a supported server or choose local music, browse and search a catalog, then play tracks, manage a queue, and optionally download or cast them. Offline access combines device files and downloads with cached library data; lyrics, radio, Android Auto, and widgets extend playback. The graph reflects documented product capabilities and the sampled call relationships; several feature implementations were not sampled, so their links rely on the README rather than inferred source calls.
Main entry points: player.ts Playback engine · downloads.ts Downloads · backend.ts Server adapters · settings.ts Preferences
Components 25
Catalog and discovery
- Browse and search
src/app/(tabs)/search.tsx - Profiles and login
src/store/auth.ts - Server adapters
src/api/backend.ts - Subsonic client
src/api/subsonic.ts - Catalog data
src/api/data.ts - Internet radio
src/app/radio.tsx
Playback and lyrics
- Player screen
src/app/player.tsx - Playback engine
src/store/player.ts - Queue state
src/lib/queue.ts - Lyrics
src/api/data.ts
Local and offline
- Local library scan
src/lib/localLibrary.ts - Offline catalog
src/lib/localQueries.ts - Downloads
src/store/downloads.ts - Library mirror
src/store/libraryMirror.ts
Device integrations
- UPnP and Sonos
modules/upnp-cast/android/src/main/java/expo/modules/upnpcast/RendererSession.kt - Cast media service
modules/cast-media/android/src/main/java/expo/modules/castmedia/CastMediaService.kt - Android Auto
modules/car-auto/android/src/main/java/expo/modules/carauto/ResonusCarBrowserService.kt - Home widget
modules/home-widget/android/src/main/java/expo/modules/homewidget/ResonusTileService.kt
App foundations
- Preferences
src/store/settings.ts - Persistent storage
src/lib/storage.ts - Theme system
src/theme/index.ts - Translations
src/i18n/index.ts
Other components
- Listener
- Music server
- Device music
Connections 27
- Listener → Browse and search: browses
README.md - Listener → Profiles and login: signs in
README.md - Profiles and login → Server adapters: creates session
src/store/auth.ts - Server adapters → Subsonic client: uses adapter
src/api/backend.ts - Browse and search → Catalog data: searches catalog
src/app/(tabs)/search.tsx - Catalog data → Subsonic client: requests catalog
src/api/data.ts - Music server → Subsonic client: serves music
README.md - Device music → Local library scan: provides tracks
README.md - Local library scan → Offline catalog: builds catalog
src/lib/localLibrary.ts - Browse and search → Player screen: selects music
README.md - Player screen → Playback engine: controls playback
src/app/player.tsx - Playback engine → Server adapters: requests tracks
src/store/player.ts - Playback engine → Queue state: manages queue
src/store/player.ts - Playback engine → UPnP and Sonos: loads remote track
src/store/player.ts - Playback engine → Lyrics: loads lyrics
README.md - Listener → Downloads: downloads music
README.md - Downloads → Server adapters: fetches album
src/store/downloads.ts - Downloads → Library mirror: refreshes mirror
src/store/downloads.ts - Offline catalog → Downloads: includes downloads
src/lib/localQueries.ts - Profiles and login → Persistent storage: persists profile
src/store/auth.ts - Preferences → Persistent storage: persists preferences
src/store/settings.ts - Preferences → Theme system: applies appearance
src/store/settings.ts - Preferences → Translations: sets language
src/i18n/index.ts - Listener → Internet radio: browses stations
README.md - Playback engine → Cast media service: streams media
- Playback engine → Android Auto: serves car controls
README.md - Playback engine → Home widget: shows now playing
README.md