📁Projects

What to Do If Script Analysis Gets Stuck

Track analysis progress, recover from failed or stuck script analysis, and handle PDF guidance safely.

🛠️ Quick Guide

Where: Project analysis processing screen

What it does: Polls the current analysis job and redirects automatically when it finishes

Error path: Shows a dedicated recovery card instead of leaving you on a broken loading state

PDF case: PDF-specific guidance can send you back to analysis with a Word-upload recommendation

What the Processing Screen Is For

If script analysis feels stuck, fails, or sends you back with PDF guidance, this is the page to watch first. It keeps tracking the active analysis job, shows live progress information, and then sends you forward automatically when the job completes.

Normal Completion Flow

  1. Start analysis from your project workflow
  2. Stay on the processing page while the job runs
  3. Watch the progress overlay and analysis log preview
  4. When analysis finishes, SurtitleLive redirects you automatically to the next destination

In normal use, you do not need to refresh this page manually.

When Analysis Fails or Needs Guidance

If the analysis job hits an error, the processing page switches to a recovery card instead of leaving you in a permanent loading state.

  • General failures show an Analysis Error state with a return button back to analysis
  • PDF-specific parsing issues show a special guidance state and can change the return button text to Return Upload Word
  • The safest next step is usually to reopen the analysis flow, review the source file, and try again with a cleaner document if needed

Best Recovery Practice

Recommendation: If a PDF repeatedly gives poor structure, switch to an editable source document such as DOCX before rerunning analysis.

  1. Return to the project's analysis page
  2. Check whether the source file format is likely to be the problem
  3. Upload a cleaner document or rerun analysis only when you are comfortable replacing the current structured result

FAQ

Common questions for this workflow, based on the current SurtitleLive system.

What should I do if script analysis gets stuck or fails?+

Stay on the processing page first. If it switches to a recovery card or PDF guidance state, return to analysis, review the source file, and rerun with a cleaner document such as DOCX if needed.

Why did analysis send me back with PDF guidance instead of finishing?+

The processing page can detect PDF-specific guidance and route you back to the analysis flow with a prompt to upload a better source, such as a Word document, when parsing quality is likely to be poor.