62 lines
3.1 KiB
Markdown
62 lines
3.1 KiB
Markdown
## 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.
|