How acousticufo/jellyfin-audio-provider works
Jellyfin Audio Provider exposes a Jellyfin music library as a native Android Storage Access Framework tree for local media players. The main flow is a player browsing provider documents, with metadata served from the local index and audio delivered by range streaming; a separate foreground sync populates that index. The graph also captures the connection, cache-management, and setup-guide UI, plus security boundaries. Some subsystem links are based on the SOURCE INDEX or README rather than complete call-site excerpts; those evidence limits are reflected in the cited paths.
Main entry points: JellyfinClient.kt Jellyfin API client · MainActivity.kt Compose navigation · JellyfinDocumentsProvider.kt Documents provider · LibrarySyncService.kt Foreground sync
Components 23
App interface
- Compose navigation
app/src/main/java/com/github/jellyfin_saf/ui/MainActivity.kt - Connection screen
app/src/main/java/com/github/jellyfin_saf/ui/screens/ConnectionScreen.kt - Cache screen
app/src/main/java/com/github/jellyfin_saf/ui/screens/CacheScreen.kt - Setup guide
app/src/main/java/com/github/jellyfin_saf/ui/screens/HelpScreen.kt
SAF documents
- Documents provider
app/src/main/java/com/github/jellyfin_saf/provider/JellyfinDocumentsProvider.kt - Document identifiers
app/src/main/java/com/github/jellyfin_saf/provider/DocumentId.kt
Library sync and index
- Foreground sync
app/src/main/java/com/github/jellyfin_saf/sync/LibrarySyncService.kt - Sync state
app/src/main/java/com/github/jellyfin_saf/sync/LibrarySyncManager.kt - Jellyfin API client
app/src/main/java/com/github/jellyfin_saf/api/JellyfinClient.kt - Jellyfin metadata models
app/src/main/java/com/github/jellyfin_saf/api/model/JellyfinModels.kt - Room database
app/src/main/java/com/github/jellyfin_saf/db/AppDatabase.kt - Track queries
app/src/main/java/com/github/jellyfin_saf/db/TrackDao.kt - Track metadata
app/src/main/java/com/github/jellyfin_saf/db/TrackEntity.kt
Streaming and cache
- Range stream proxy
app/src/main/java/com/github/jellyfin_saf/stream/ProxyStreamHandler.kt - Playback foreground service
app/src/main/java/com/github/jellyfin_saf/stream/StreamingService.kt - Fetched byte ranges
app/src/main/java/com/github/jellyfin_saf/stream/IntervalSet.kt - LRU disk cache
app/src/main/java/com/github/jellyfin_saf/cache/LRUCacheManager.kt
Security
- Input and path validation
app/src/main/java/com/github/jellyfin_saf/security/InputValidator.kt - Encrypted preferences
app/src/main/java/com/github/jellyfin_saf/security/SecurePreferences.kt
Other components
- App user
- SAF media player
- Android SAF
- Jellyfin server
Connections 36
- App user → Compose navigation: configures
app/src/main/java/com/github/jellyfin_saf/ui/MainActivity.kt - Compose navigation → Connection screen: shows
app/src/main/java/com/github/jellyfin_saf/ui/MainActivity.kt - Compose navigation → Cache screen: shows
app/src/main/java/com/github/jellyfin_saf/ui/MainActivity.kt - Compose navigation → Setup guide: shows
app/src/main/java/com/github/jellyfin_saf/ui/MainActivity.kt - Compose navigation → Jellyfin API client: provides
app/src/main/java/com/github/jellyfin_saf/ui/MainActivity.kt - Compose navigation → LRU disk cache: provides
app/src/main/java/com/github/jellyfin_saf/ui/MainActivity.kt - Connection screen → Jellyfin API client: uses
app/src/main/java/com/github/jellyfin_saf/ui/screens/ConnectionScreen.kt - Connection screen → Foreground sync: starts
app/src/main/java/com/github/jellyfin_saf/ui/screens/ConnectionScreen.kt - Connection screen → Sync state: observes
app/src/main/java/com/github/jellyfin_saf/ui/screens/ConnectionScreen.kt - Cache screen → LRU disk cache: manages
app/src/main/java/com/github/jellyfin_saf/ui/screens/CacheScreen.kt - Cache screen → Encrypted preferences: reads settings
app/src/main/java/com/github/jellyfin_saf/ui/screens/CacheScreen.kt - SAF media player → Android SAF: opens provider
README.md - Android SAF → Documents provider: dispatches
README.md - Documents provider → Document identifiers: uses identifiers
app/src/main/java/com/github/jellyfin_saf/provider/JellyfinDocumentsProvider.kt - Documents provider → Jellyfin API client: queries metadata
app/src/main/java/com/github/jellyfin_saf/provider/JellyfinDocumentsProvider.kt - Documents provider → Room database: reads index
app/src/main/java/com/github/jellyfin_saf/provider/JellyfinDocumentsProvider.kt - Documents provider → Track metadata: builds records
app/src/main/java/com/github/jellyfin_saf/provider/JellyfinDocumentsProvider.kt - Documents provider → Range stream proxy: opens audio
app/src/main/java/com/github/jellyfin_saf/provider/JellyfinDocumentsProvider.kt - Foreground sync → Jellyfin API client: fetches library
app/src/main/java/com/github/jellyfin_saf/sync/LibrarySyncService.kt - Foreground sync → Room database: stores index
app/src/main/java/com/github/jellyfin_saf/sync/LibrarySyncService.kt - Foreground sync → Track metadata: creates records
app/src/main/java/com/github/jellyfin_saf/sync/LibrarySyncService.kt - Foreground sync → LRU disk cache: updates cache
app/src/main/java/com/github/jellyfin_saf/sync/LibrarySyncService.kt - Foreground sync → Sync state: publishes progress
app/src/main/java/com/github/jellyfin_saf/sync/LibrarySyncService.kt - Jellyfin API client → Jellyfin server: requests metadata
README.md - Jellyfin API client → Encrypted preferences: uses credentials
app/src/main/java/com/github/jellyfin_saf/api/JellyfinClient.kt - Jellyfin API client → Jellyfin metadata models: decodes responses
app/src/main/java/com/github/jellyfin_saf/api/JellyfinClient.kt - Room database → Track queries: exposes queries
app/src/main/java/com/github/jellyfin_saf/db/AppDatabase.kt - Track queries → Track metadata: queries records
app/src/main/java/com/github/jellyfin_saf/db/TrackDao.kt - Range stream proxy → Jellyfin server: requests byte ranges
README.md - Range stream proxy → LRU disk cache: reads and writes
app/src/main/java/com/github/jellyfin_saf/stream/ProxyStreamHandler.kt - Range stream proxy → Fetched byte ranges: tracks fetched ranges
app/src/main/java/com/github/jellyfin_saf/stream/ProxyStreamHandler.kt - Range stream proxy → Playback foreground service: uses service
app/src/main/java/com/github/jellyfin_saf/stream/ProxyStreamHandler.kt - LRU disk cache → Room database: updates cache status
app/src/main/java/com/github/jellyfin_saf/cache/LRUCacheManager.kt - LRU disk cache → Input and path validation: validates paths
app/src/main/java/com/github/jellyfin_saf/cache/LRUCacheManager.kt - Document identifiers → Input and path validation: validates identifiers
app/src/main/java/com/github/jellyfin_saf/provider/DocumentId.kt - Encrypted preferences → Android SAF: encrypts with Keystore