# 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):
```bash
python main.py --paths-file paths.txt
```

**Faster checks** (check every 1 minute for up to 30 minutes):
```bash
python main.py --paths-file paths.txt --retry-minutes 1 --retry-timeout 30
```

**Longer patience** (check every 5 minutes for up to 4 hours):
```bash
python main.py --paths-file paths.txt --retry-minutes 5 --retry-timeout 240
```

## Configuration

Edit `config.xml` to change defaults:
```xml
<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.