Queue Retry Quick Reference

What This Fixes

Previously: When a source becomes temporarily unavailable (e.g., P:\tv goes offline), the batch would fail with 25 "Folder not found" errors and stop without recovery.

Now: The batch will automatically detect this scenario and wait for the source to come back online, then automatically retry all failed items.

Quick Start

Default behavior (10 minute checks for 60 minutes total):

python main.py --paths-file paths.txt

Faster checks (check every 1 minute for up to 30 minutes):

python main.py --paths-file paths.txt --retry-minutes 1 --retry-timeout 30

Longer patience (check every 5 minutes for up to 4 hours):

python main.py --paths-file paths.txt --retry-minutes 5 --retry-timeout 240

Configuration

Edit config.xml to change defaults:

<queue_retry>
  <retry_minutes>10</retry_minutes>    <!-- Change this -->
  <retry_timeout>60</retry_timeout>    <!-- Or this -->
</queue_retry>

Key Features

✅ Automatic detection - Detects when source is down (2+ "Folder not found" errors) ✅ Continuous monitoring - Checks source availability at regular intervals ✅ Immediate restart - Restarts processing as soon as source is reachable ✅ Smart timeout - Gives up after configured timeout to prevent infinite loops ✅ Full logging - All retry attempts logged with timestamps ✅ No manual intervention - Runs completely automatically

What Triggers Retry Logic

Queue mode (--paths-file) only
Failed count > 2
All failures are "Folder not found" type
At least one failed path exists but is unreachable

What Gets Retried

Only the items that failed with "Folder not found" error are retried. Items that failed for other reasons are skipped.

Monitoring

The system outputs clear progress messages:

Attempt number and timing
Elapsed vs remaining time
What it's waiting for
When source becomes reachable
Final summary

All activity is logged to logs/conversion.log.* files.

2.0 KiB Raw Blame History