gwutilz/gwencoder/docs/phases/PHASE3_PLAN.md

Phase 3 Implementation Plan

Overview

Phase 3 focuses on:

1. Adding CLI flags for all new features
2. Implementing remaining features (downmix, subtitle extraction)
3. Refactoring code to use structured options
4. Testing and validation

Implementation Steps

Step 1: Refactor encodeFile() to use EncodingOptions struct

• Create EncodingOptions struct
• Update function signature
• Update all callers

Step 2: Add CLI flag parsing

• Parse AV1 advanced flags
• Parse audio flags
• Parse stream operation flags
• Parse force-transcode flag

Step 3: Integrate flags into encoding

• Pass options to encodeFile()
• Apply AV1 options
• Apply audio options
• Apply stream options

Step 4: Implement remaining features

• Downmix track creation
• Subtitle extraction
• Remove subtitles after extract

Step 5: Update help text

• Document all new flags
• Add usage examples

Priority Order

1. ✅ Refactor to EncodingOptions (in progress)
2. ⏳ Add --force-transcode flag
3. ⏳ Add AV1 advanced flags (preset, CRF, tune, maxrate)
4. ⏳ Add audio quality preset flag
5. ⏳ Add stream operation flags
6. ⏳ Implement downmix creation
7. ⏳ Implement subtitle extraction