Content Platform – Video – Video processing progress indicator
Goal
Show users a clear processing progress for uploaded videos (e.g., encoding, thumbnailing), including % complete and “time left” when possible.
UX (where it appears)
In the editor (Video Post / Article media block):
Progress bar +
Processing: 42%Status text:
Uploading→Processing→Ready
In a global uploads panel (optional):
list of recent uploads + progress
On published content:
if still processing, show placeholder + “Video is processing”
Status model
Use a single state machine:
uploading(0–100 client-side)queued(0%)processing(1–99%)ready(100%)failed
Backend requirements
1) Job tracking table
video_jobs
iduser_idvideo_idstatusprogress(0–100 integer)stage(upload,transcode,thumbnail,finalize)errorupdated_at
2) Progress updates from processor
Wherever you process video (Cloud Run/Functions/worker):
emit progress events periodically:
by stage boundaries (simple)
or real encode progress (best)
Minimum viable (stage-based):
queued 0
transcode 20–90
thumbnail 90–95
finalize 95–100
Best (true %):
parse ffmpeg progress and map to 0–100.
3) Client realtime updates
Choose one:
Firestore document per job (easy realtime)
SSE endpoint
/api/video/jobs/:id/streamWebSocket (if you already have)
Polling fallback every 2–5s
Display “% left”
Show
100 - progressas “X% remaining”Optional ETA:
compute from progress velocity (last 3 updates)
Failures + retries
If
failed, show:error message
“Retry processing” button (requeue job)
If stuck (no updates for N minutes):
mark as
stalledand offer retry
Dev steps
Add
video_jobstracking + status/progress fields.Update processing pipeline to publish progress updates.
Implement realtime subscription in Svelte UI with polling fallback.
Add placeholder behavior for content not yet ready.
QA: large files, slow networks, background tab, mobile.
Outcome: users stop guessing and can see exactly how much processing is left before their video is ready.