Video-encoder-still-effed/docs/encoding_versions.md

Encoding Settings Changelog

This document tracks changes to the encoding settings used by videnc over time.

Version 1.0 - Initial Release (2025-10-04)

Universal Settings

These settings are applied to all videos regardless of source material:

• Video Codec: libsvtav1 (AV1)
• Pixel Format: yuv420p10le
• Preset: 4 (universal setting)
• enable-overlays: 1 (enabled for all encodings)
• enable-qm: 1 (enabled for all encodings)
• qm-min: 0
• qm-max: 15
• scd: 1 (scene change detection enabled)
• film-grain-denoise: 1 (enabled for all encodings)
• tune: 0 (default tuning)

Variable Settings

These settings vary based on video characteristics:

Resolution-Based Settings

• CRF: 30 for videos < 1 MPixel, 28 for videos >= 1 MPixel
• film-grain: 10 for videos < 1 MPixel, 5 for videos >= 1 MPixel

Source Material Dependent Settings

These settings are conditionally applied based on the characteristics of the source video:

• Deinterlacing: Applied when isInterlaced is detected

  • Filter: bwdif=mode=0

• Anamorphic Correction: Applied when isAnamorphic is detected

  • Filter chain: scale=iw*sar:ih:lanczos,setsar=1,scale=-2:ih:lanczos

• Keyframe Interval: Dynamically calculated based on video FPS

  • Value: Math.round(videoInfo.fps * 5)

Audio Settings

• Audio Codec: libopus for all audio streams
• Channel Layout: Preserved from source (with special handling for sideloaded audio)
• Language Metadata: Preserved for each stream
• Disposition: English audio tracks set as default

Subtitle Settings

• Subtitle Handling: Copy (no re-encoding)
• Language Metadata: Preserved for each stream
• Disposition: Finnish subtitle tracks set as default

Metadata Handling

• Metadata Stripping: Original metadata is stripped (-map_metadata -1)
• Custom Metadata: Added from OMDB API or user input
• Encoding Version: Added as ENCODING_VERSION=1.0