Files
PodTui/tasks/episode-downloads/16-download-progress-tracking.md
2026-02-05 22:55:24 -05:00

1.3 KiB

16. Implement Download Progress Tracking

meta: id: episode-downloads-16 feature: episode-downloads priority: P2 depends_on: [episode-downloads-15] tags: [progress, state-management, downloads]

objective:

  • Track download progress for each episode
  • Update download state in real-time
  • Store download progress in persistent storage

deliverables:

  • Download progress state in app store
  • Progress update utility
  • Integration with download utility

steps:

  1. Add download state to app store
  2. Update progress during download
  3. Save progress to persistent storage
  4. Handle download completion
  5. Test progress tracking accuracy

tests:

  • Unit: Test progress update logic
  • Integration: Test progress tracking with download
  • Persistence: Verify progress saved and restored

acceptance_criteria:

  • Download progress is tracked accurately
  • Progress updates in real-time
  • Progress persists across app restarts

validation:

  • Download a large file and watch progress
  • Verify progress updates at intervals
  • Restart app and verify progress restored

notes:

  • Use existing progress store for episode playback
  • Create separate download progress store
  • Update progress every 1-2 seconds
  • Handle download cancellation by resetting progress
  • Store progress in XDG_CONFIG_HOME directory