Repository navigation
Complete Android download queue management and offline polish #53
Description
Parent
Status
Shipped in #312. Open only for the live signed-in proof below; the mobile app signs in only through the Auth Tab password form, so it needs one human devs-auto sign-in (same blocker as #107).
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 concurrent-download limit (1–4, default 3, as on iOS main) 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). - 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 (feat(mobile): manage the download queue and polish offline playback #312).
- Notification and permission-disabled states are both verified (feat(mobile): manage the download queue and polish offline playback #312 recording).
- 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.- Live
devs-autolane: airplane-mode resume andstart_fromreadback, a notification tap while signed in, missing-copy recovery, and queue order across a real process kill.
Boundaries
- Post-v1; does not gate Epic: native Android rewrite #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)