fix(ffmpeg): add structured load errors, retries, and troubleshooting…#1170
Open
Viraj0711 wants to merge 4 commits into
Open
Conversation
|
@Viraj0711 is attempting to deploy a commit to the magic-peach1's projects Team on Vercel. A member of the Team first needs to authorize it. |
Contributor
👋 Thanks for your PR, @Viraj0711!Welcome to Reframe — a browser-based video editor built for everyone 🎬 What happens next
Quick checklist
Useful links
Happy coding! 🎉 |
Contributor
✅ PR Format Check Passed — @Viraj0711Basic format checks passed. A maintainer will review your code changes. This does not mean the PR is approved — it just means the format is correct. |
github-actions
Bot
added
level:advanced
…ured errors and upstream worker + UI changes
…r, combine hook + UI changes
Author
|
label: gssoc'26 |
…ps and functionality, and update FFmpeg load options
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Title
Fix FFmpeg load failures with retries and recovery UI
Description
This PR improves FFmpeg.wasm loading reliability and makes export failures easier to recover from. Instead of surfacing a generic failure when the FFmpeg core fails to download or initialize, the loader now produces structured errors with machine-readable codes and user-friendly messages.
It also adds automatic retry logic with exponential backoff for transient load issues, so temporary network/CDN problems don’t immediately break exports. On the UI side, export failures now show a clearer message, a retry action, and a troubleshooting link instead of exposing technical details to users.
What changed
-Added structured
FFmpegLoadErrormetadata inffmpeg.ts-Added retry handling with exponential backoff for FFmpeg loading
-Improved export error handling in
useVideoEditor.ts-Updated the export error UI in
VideoEditor.tsx-Added FFmpeg troubleshooting docs in
ffmpeg-troubleshooting.md-Added/updated tests for retry, timeout, and failure cases
Validation
-Ran targeted Vitest coverage for FFmpeg helper and loader tests
-Confirmed the new FFmpeg-related TypeScript errors were resolved
Closes #1165