Repository navigation
Complete Android download queue management and offline polish #53
Description
Parent
What this delivers
The lean mobile-v1 download path from #28 gains the queue-management and lifecycle polish intentionally deferred from launch: bounded concurrency, understandable queued/running/failed state, bulk cleanup, and completion behavior users can trust.
Scope
- Configurable or product-decided concurrent-download limit with a visible queue.
- Queued, running, paused/retryable, failed, complete, and removed states with deterministic recovery.
- Numeric progress where the platform source provides a trustworthy denominator.
- Multi-select removal of local copies without deleting remote originals unless a separate confirmed action is chosen.
- Completion/failure notifications that deep-link to the local item and respect notification permission state.
- Storage-pressure and unavailable-local-file recovery.
- Offline playback resumes from and syncs
start_from(iOS mainOfflineVideoPlaybackPositionSync; todayOfflinePlaybackRepositorystarts at 0). - Download concurrency setting (iOS main: 1–4, default 3; today 1).
- HLS downloads skip subtitles for
hide_subtitlesaccounts, and the confirmed setting is stored with the download so a cold offline start hides the picker.
Acceptance criteria
- Queue ordering and concurrency survive process recreation.
- Failed or interrupted downloads recover without silently losing queue state.
- Bulk local deletion cannot delete remote originals implicitly.
- Notification and permission-disabled states are both verified.
- Offline playback and local-availability indicators remain correct after queue operations.
Verification
- State-machine tests with controlled download progress and process restoration.
- Emulator/device recording covering queueing, retry, completion, bulk cleanup, airplane mode, and storage failure.
./gradlew verifyand mobile debug assemble green.
Blocked by
Boundaries
- Post-v1; does not gate Epic: native Android rewrite — Compose mobile + Android TV from one codebase #14.
- No public-link or remote-trash behavior.
- Do not persist token-bearing download URLs in logs, notifications, or durable queue metadata.
Activity
altaywtf commentedon Sep 30, 2026
Audit follow-ups for this issue (UX audit in #14, 2026-09-30):
start_from(mobile/downloads/OfflinePlaybackRepository.kt:35,43); iOS main resumes and syncs offline positions (OfflineVideoPlaybackPositionSync.swift).hide_subtitleson (found in fix(playback): pick the server's default subtitle and hide subtitles entirely with hide_subtitles #261).altaywtf commentedon Sep 30, 2026
One more from #261's review: on a cold offline start, settings can't load, so a
hide_subtitlesaccount still sees the Captions picker for offline playback. Fix alongside the HLS-download subtitle item above (e.g. cache the confirmedhide_subtitleswith the download).fix(mobile): keep the player's newer position, quiet other accounts a…
fix(mobile): rebuild rows for downloads the index lost instead of del…
refactor(mobile): attach offline positions after the runtime is built
feat(mobile): manage the download queue and polish offline playback (#…
altaywtf commentedon Oct 4, 2026
Shipped in #312: a visible queue with a 1–4 concurrency setting (default 3), queued, downloading, paused, failed, complete, missing and deleting states that recover after restart, multi-select local removal that never touches put.io originals, permission-aware notifications, low-storage pause, offline `start_from` resume and sync (iOS rules), and `hide_subtitles` for HLS downloads.
Written by an agent (Claude Code, Opus 5.5)