Adds Room + WorkManager-backed offline downloads: a bitrate picker
(Low/Normal/High/Original) on track and album detail screens, a
Downloads library screen, and Settings additions for Wi-Fi-only
downloads and default quality. Bitrate tiers route through Subsonic's
`stream` endpoint with `maxBitRate`; Original uses `download`, which
always returns the untranscoded source file.
Three real bugs found and fixed during on-device verification:
- WorkManager was constructing DownloadWorker with its default
reflection-based WorkerFactory instead of HiltWorkerFactory
(NoSuchMethodException on the @AssistedInject constructor). The
default androidx.startup auto-init ran before Hilt's field
injection was guaranteed to have happened. Fixed by disabling the
manifest's auto-init provider and calling WorkManager.initialize()
manually in DeepwaveApplication.onCreate(), after super.onCreate().
- Crash on every download: WorkManager's own SystemForegroundService
declares no foregroundServiceType in its manifest, but the worker
requests dataSync at runtime via ForegroundInfo, which API 29+
requires to be a subset of what's manifest-declared. Fixed by
manifest-merging that service with foregroundServiceType="dataSync".
- Offline playback was completely broken: ResolvingDataSource only
rewrites the DataSpec's URI (to file:// for a downloaded track) but
always hands it to the same wrapped upstream DataSource to open.
OkHttpDataSource can only open http(s) URLs, so the rewritten
file:// URI failed with "Malformed URL" and playback silently fell
through to the network. Wrapping the signed OkHttpDataSource.Factory
in DefaultDataSource.Factory routes by scheme instead - this bug was
latent since Phase 4, since LocalTrackFiles was always empty until
now and the local-file path was never actually exercised.
- Re-downloading a track at a different quality could produce a
different file extension (Content-Type-driven), orphaning the
previous file on disk with no cleanup path. DownloadWorker now
clears any existing files for the track id before writing the new
one.
Verified on-device: downloads at all four tiers produce distinctly
different, correctly-ordered file sizes (Low < Normal < High <
Original); a fully downloaded track keeps playing with Wi-Fi and
mobile data both disabled; killing and relaunching the app mid-download
lets WorkManager resume the interrupted download to a correct,
byte-exact final file.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Redirects Deepwave from a vanilla Subsonic client toward the Spotify/
SoundCloud-style product the user wants, per the Phase 2+ roadmap.
- Dark-first Material3 theme with a fixed aqua accent (no Material You
dynamic color), full type scale, rounded-corner shape system
- Typed (@Serializable) navigation routes; new bottom-tab shell
(Home/Search/Library) with a settings entry point and mini-player
placeholder bar, replacing the single placeholder Home screen
- Logout moved out of Home into a dedicated Settings screen
- Reusable component library (TrackRow, AlbumCard, ArtistCard,
ArtworkPlaceholder, BottomNavBar, MiniPlayerBar) for Phase 3 to wire
real data into
- Strings externalized to strings.xml
- Security fix: exclude the Tink keyset and encrypted credentials
DataStore from Android auto-backup (backup_rules.xml /
data_extraction_rules.xml), previously unexcluded despite
allowBackup=true
- Fix: Home screen's content column was missing verticalScroll,
making it unscrollable once content exceeds the viewport; also
added breathing room between each row's header and its cards
- Split Login/Settings into stateless content composables + thin
ViewModel-wired wrappers, and added @Preview coverage (including
interactive previews for MainScreen and BottomNavBar) across every
screen and component so the UI can be reviewed in Android Studio's
preview pane without running on a device
Added material-icons-extended as a pragmatic deviation from the
Phase 2 plan (no new deps) since later phases all need icons outside
Compose's small default set (play/pause/skip/download/playlist).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Spotify-like Navidrome client scaffold with Hilt DI, a Subsonic API
client (token auth, base-URL rewriting), encrypted single-server
credential storage (DataStore + Tink/Keystore), and a login/session
flow gating Compose Navigation between Login and a placeholder Home
screen.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
