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

1.9 KiB

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).