# AV1 Encoder Support - Fix Summary

## Problem
When using the `av1_quality` profile, encoding was falling back to CPU instead of using Intel QSV GPU acceleration.

## Root Cause
The `EncoderType` enum didn't include AV1 variants, so when the config specified `encoder: intel_qsv_av1`, it failed to map and silently fell back to `CPU_X265`.

## Fix Applied
Added complete AV1 support to reencode.py:

1. **New Encoder Types**: `INTEL_QSV_AV1`, `NVIDIA_NVENC_AV1`, `AMD_VAAPI_AV1`, `CPU_AV1`
2. **Detection**: Now checks for `av1_qsv`, `av1_nvenc`, `av1_vaapi`, `libsvtav1` encoders
3. **FFmpeg Commands**: Proper AV1 encoding commands for each hardware type
4. **Container Format**: AV1 automatically uses .mp4 (not .m4v)

## Next Steps - Testing in Docker

### 1. Copy the test script to your Docker container
```bash
docker cp test-av1-support.sh encoderpro:/app/
```

### 2. Run the test inside the container
```bash
docker exec encoderpro bash /app/test-av1-support.sh
```

### 3. Check the output

**Expected Results:**

✅ **If Intel QSV AV1 is supported** (Arc A-Series GPUs):
```
Intel QSV AV1:
V..... av1_qsv              AV1 (Intel Quick Sync Video acceleration)
  [FOUND]
```

❌ **If Intel QSV AV1 is NOT supported** (older GPUs or FFmpeg build):
```
Intel QSV AV1:
  [NOT FOUND]
```

## Scenarios

### Scenario A: Intel QSV AV1 is Available
✅ Your GPU supports AV1!
- The `av1_quality` profile will now use GPU acceleration
- You should see fast encoding speeds (80-150 fps)
- Use profiles: `av1_quality`, `av1_qsv`, `sweetspot_av1`

### Scenario B: Intel QSV AV1 is NOT Available
⚠️ Your GPU doesn't support AV1 (integrated graphics or older Arc GPU)

**Options:**
1. **Use H.265 instead** (recommended):
   - Change to `sweetspot_qsv` or `quality_qsv` profiles
   - Still uses GPU, excellent quality

2. **Use CPU AV1** (very slow):
   - Keep using `av1_quality` - will fallback to CPU
   - Much slower but will work

3. **Update FFmpeg build**:
   - Docker image might need newer FFmpeg with AV1 support

## How to Switch Profiles

If AV1 isn't supported, update your config.yaml:

```yaml
profiles:
  # Change from:
  # default: av1_quality

  # To:
  default: sweetspot_qsv  # H.265 GPU encoding - fast & excellent quality
```

Or select a different profile in the dashboard dropdown.

## Testing the Fix

1. **Run the test script** in Docker (above)
2. **Check encoder capabilities** when running reencode.py:
   ```bash
   docker exec encoderpro python3 /app/reencode.py -c /config/config.yaml --stats
   ```

   Look for:
   ```
   ENCODER CAPABILITIES
   ============================================================
   Intel QSV:        [YES]
     AV1:            [YES]  ← This line shows if QSV AV1 is available
   ```

3. **Try encoding a file** with the dashboard
   - Select a file
   - Choose `av1_quality` or `sweetspot_qsv` profile
   - Click "Encode Selected"
   - Check the logs to see which encoder is used

## Relevant Config Profiles

From your config.yaml:

```yaml
# AV1 Profiles (require Arc A-Series or newer)
sweetspot_av1:
  encoder: intel_qsv_av1   # Now properly recognized!
  preset: medium
  quality: 27

av1_quality:
  encoder: intel_qsv_av1   # This was failing before, fixed now
  preset: slow
  quality: 24

# H.265 Profiles (work on all Intel GPUs with QSV)
sweetspot_qsv:
  encoder: intel_qsv_h265  # Safe fallback, excellent quality
  preset: slow
  quality: 21
```

## Files Modified
- `reencode.py` - Added AV1 support (lines 56-69, 88-103, 230-245, 715-803, 1024-1046)

## Questions to Answer

After running the test script in Docker:

1. **Does your FFmpeg build have `av1_qsv` encoder?**
2. **What GPU do you have?** (Arc A380/A750/A770 support AV1, integrated graphics may not)
3. **Do you want to use H.265 instead if AV1 isn't available?**