[Triage] Understanding what is Pending vs Failed?

[SenorFusion]

Describe the bug

I'm not sure if this is an actual bug or if I just don't understand how Pinchflat works.

It's unclear when videos are actually pending and will eventually be downloaded and when they have failed.

To Reproduce
Steps to reproduce the behavior:

Task queue says No tasks are running
Pending tab shows 20 videos
If I select a specific video that is "pending" > tasks > the description reads like it was already "completed" yesterday:

Pinchflat.Downloading.MediaDownloadWorker completed 2025-02-19 17:59:23

Searching the log for yt-dlp I see no results (which goes back about 10 hours)
Searching the actual files, this video was not downloaded

Going to a pending video > Actions > Force Download
Video downloads correctly
Now the Tasks page has 2 entries:

Pinchflat.Downloading.MediaDownloadWorker 	completed 	2025-02-19 17:59:23
Pinchflat.Downloading.MediaDownloadWorker 	completed 	2025-02-20 10:31:26

I guess this is confusing for two reasons.

1. It seems like maybe if those two tasks on that video resulting in different things (pending vs success), the task log should say so
2. because the Source > Tasks > page shows the Index job is scheduled. So I assumed a pending Video > Tasks > would show that the Download is scheduled, but maybe that is incorrect.

Edit to Add: Adding a new source immediately starts indexing and downloading those, with no movement on the other Sources Pending downloads.

Expected behavior

If this download failed, it could let me know

If it didn't fail and it's really is just pending, how do I know? (It is listed as Pending but has no scheduled tasks and task log reads like is completed but didn't, and the whole app has no tasks running)

and how would I know when it will be retried?

Or if my IP got banned or rated limited by YT, how would I know?

Diagnostic info

• App Version: 2025.1.27
• yt-dlp Version: 2025.02.19
• Apprise Version: v1.9.2
• System Architecture: x86_64-pc-linux-gnu
• Timezone: America/New_York

Additional context

Sorry if this is in the docs somewhere, I did search existing issues and the docs and didn't see anything, except maybe this is solved by #610

[kieraneglin]

Hey there! Thanks for the report (:

This is indeed solved by #610 which I should be sending out either today or tomorrow!