Files
tdarr-plugs/agent_notes/av1_plugin_analysis.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

35 lines
1.9 KiB
Markdown

# AV1 Plugin Analysis
## Exposed Feature & Defaults
| Feature | Input Name | Default Value | Description |
| :--- | :--- | :--- | :--- |
| **CRF** | `crf` | `29` | Constant Rate Factor. Main quality knob. |
| **Preset** | `preset` | `10` | Speed/Efficiency tradeoff. 10 is real-time/fast. |
| **Tune** | `tune` | `0` (VQ) | Visual Quality tuning. |
| **Bitrate Cap** | `maxrate_cap` | `0` (Unlimited) | Max bitrate in kbps. |
| **Resolution** | `max_resolution` | `none` | Downscaling target. |
| **Auto-CRF** | `resolution_crf_adjust`| `enabled` | Adjusts CRF based on res (+2 for 4K, -2 for 720p). |
| **SCD** | `scd` | `1` (On) | Scene Change Detection. |
| **AQ Mode** | `aq_mode` | `2` (DeltaQ) | Adaptive Quantization mode. |
| **Lookahead** | `lookahead` | `-1` (Auto) | Frames to look ahead. |
| **Temporal Filtering**| `enable_tf` | `1` (On) | Temporal filtering for noise/quality. |
| **Threads** | `threads` | `0` (Auto) | Thread count. |
| **Keyint** | `keyint` | `-2` (~5s) | Keyframe interval. |
| **Hierarchy** | `hierarchical_levels`| `4` | Temporal layers (5 layers). |
| **Film Grain** | `film_grain` | `0` (Off) | Synth grain level. |
| **Bit Depth** | `input_depth` | `8` | 8-bit vs 10-bit. |
| **Fast Decode** | `fast_decode` | `1` (On) | Optimization for decode speed. |
## Internal / Hardcoded Settings
These settings are not exposed to the user in the Tdarr UI and are hardcoded in the plugin logic:
* **qmin**: `10` (Minimum Quantizer, prevents extreme quality boost that wastes space)
* **qmax**: `50` (Maximum Quantizer, prevents extreme quality loss)
* **Buffer Size**: Calculated as `2.0 * maxrate` (only if maxrate is set).
* **Pixel Format**:
* For 8-bit: Implicit (standard `yuv420p` usually).
* For 10-bit: Explicitly set to `yuv420p10le`.
* **Audio/Subs**: `-c:a copy -c:s copy` (Passthrough).
* **Data Streams**: `-dn` (Discarded).