Files
tdarr-plugs/agent_notes/misc_fixes_walkthrough.md
Tdarr Plugin Developer aa71eb96d7 Initial commit: Tdarr plugin stack
Plugins:
- misc_fixes v2.8: Pre-processing, container remux, stream conforming
- stream_organizer v4.8: English priority, subtitle extraction, SRT conversion
- combined_audio_standardizer v1.13: AAC/Opus encoding, downmix creation
- av1_svt_converter v2.22: AV1 video encoding via SVT-AV1

Structure:
- Local/ - Plugin .js files (mount in Tdarr)
- agent_notes/ - Development documentation
- Latest-Reports/ - Error logs for analysis
2025-12-15 11:33:36 -08:00

38 lines
1.7 KiB
Markdown

# Misc Fixes Plugin v2.0 - "Megamix" Update
## Overview
Major update consolidating functionality from popular plugins (`Migz Remux`, `Migz Image Removal`, `Lmg1 Reorder`) into a single, efficient pre-processing tool.
## New Features
### 1. Remux & Conform (`force_conform`)
- **Remuxes** video to your target container (`mkv` or `mp4`).
- **Drops incompatible streams** automatically:
- **MKV**: Drops `mov_text`, `eia_608`, `timed_id3`, and general `data` streams.
- **MP4**: Drops `hdmv_pgs_subtitle`, `eia_608`, `subrip` (srt), `timed_id3`.
### 2. Image Stream Removal (`remove_image_streams`)
- Detects and removes video streams that are actually images (often cover art or spam).
- Targets: `mjpeg`, `png`, `gif`.
### 3. Video Stream Sorting (`ensure_video_first`)
- Ensures the **Video** stream is always mapped first (Stream 0).
- Order: Video → Audio → Subtitles → Data → Attachments.
- Fixes compatibility with players that expect video at index 0.
### 4. Expanded Timestamp Fixes (`fix_ts_timestamps`)
- Now supports **AVI**, **MPG**, and **MPEG** in addition to TS.
- Applies `-fflags +genpts` (and `+igndts` for TS) to fix "unknown timestamp" errors.
## New Inputs
| Input | Type | Default | Description |
|-------|------|---------|-------------|
| `target_container` | Dropdown | `mkv` | Target output container. |
| `force_conform` | Bool | `true` | Drop incompatible streams. |
| `remove_image_streams` | Bool | `true` | Remove non-video video streams. |
| `ensure_video_first` | Bool | `true` | Enforce standard stream order. |
| `fix_ts_timestamps` | Bool | `true` | Apply timestamp fixes. |
## Usage
Place this plugin **first** in your plugin stack to clean and standardize files before further processing.