## Tdarr Plugin Suite

Custom, modular Tdarr plugin stack for media transcoding and library hygiene.

### Recommended Plugin Stack (Pre‑processing → Encoding)

1. **Tdarr_Plugin_00_file_audit** (v1.x) – Read‑only audit  
   - Logs container, streams, and potential issues for MKV/MP4.
2. **Tdarr_Plugin_01_container_remux** (v2.x) – Container & timestamp fixes  
   - Remux to MKV/MP4, fixes legacy TS/AVI/MPG timestamp issues.
3. **Tdarr_Plugin_02_stream_cleanup** (v1.x) – Stream removal  
   - Drops image/data/corrupt streams and container‑incompatible tracks.
4. **Tdarr_Plugin_03_stream_ordering** (v1.x) – Stream ordering  
   - Ensures `Video → Audio → Subtitles`, prioritizes English, optional dispositions.
5. **Tdarr_Plugin_04_subtitle_conversion** (v2.x) – Container‑aware subs  
   - MKV→SRT, MP4→mov_text, keeps image subs as‑is.
6. **Tdarr_Plugin_05_subtitle_extraction** (v1.x, optional) – External .srt  
   - Extracts selected subtitle languages to sidecar files.
7. **Tdarr_Plugin_06_cc_extraction** (v1.x, optional) – Closed captions  
   - Uses CCExtractor to pull EIA‑608 style captions when enabled.
8. **Tdarr_Plugin_combined_audio_standardizer** (v1.24) – Audio standardizer  
   - Opus/AAC conversion, **always preserves original channels**, adds downmix tracks,
     container‑aware Opus mapping, quality presets.
9. **Tdarr_Plugin_av1_svt_converter** (v3.19) – AV1 video encoder  
   - SVT‑AV1 v3.x, CRF/VBR modes, resolution caps, bitrate & source‑codec awareness.

Legacy monolithic plugins `Tdarr_Plugin_misc_fixes` and `Tdarr_Plugin_stream_organizer`
have been **fully replaced** by the numbered modular plugins above and are kept only
for historical reference under `agent_notes/archive/` and `agent-notes/archived/`.

### Directory Structure

```text
tdarr_plugs/
├── Local/                   # Active Tdarr plugin files (mount this in Tdarr)
│   ├── Tdarr_Plugin_00_file_audit.js
│   ├── Tdarr_Plugin_01_container_remux.js
│   ├── Tdarr_Plugin_02_stream_cleanup.js
│   ├── Tdarr_Plugin_03_stream_ordering.js
│   ├── Tdarr_Plugin_04_subtitle_conversion.js
│   ├── Tdarr_Plugin_05_subtitle_extraction.js
│   ├── Tdarr_Plugin_06_cc_extraction.js
│   ├── Tdarr_Plugin_combined_audio_standardizer.js
│   └── Tdarr_Plugin_av1_svt_converter.js
├── JobReports/              # Saved Tdarr job reports for analysis
├── agent_notes/             # Detailed design notes, analyses, and plans
│   └── archive/             # Archived legacy plugin files, old experiments
├── agent-notes/             # Additional consolidated notes/archives
├── PLUGIN_DOCUMENTATION.md  # In‑depth per‑plugin documentation
├── COMPREHENSIVE_REVIEW_REPORT.md
├── OPTIMIZATION_REPORT.md
└── README.md
```

### Usage

- Mount the `Local/` directory as your **Local Plugins** folder in Tdarr.  
- Apply the plugins in the order above for best results (fail‑fast audits and cleanup
  before any expensive video encoding).  
- Refer to `PLUGIN_DOCUMENTATION.md` and `COMPREHENSIVE_REVIEW_REPORT.md` for
  deeper technical details and rationale.