From 5b4b36c9281dda80a33bb7ff5c822aa0a71bdec7 Mon Sep 17 00:00:00 2001 From: Esa Kataja Date: Sat, 4 Oct 2025 18:21:51 +0300 Subject: [PATCH] chore: tweak encoding version documentation format --- docs/encoding_versions.md | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/encoding_versions.md b/docs/encoding_versions.md index 7deb03b..9482be0 100644 --- a/docs/encoding_versions.md +++ b/docs/encoding_versions.md @@ -1,8 +1,10 @@ -# Encoding Settings Version 1.0 +# Encoding Settings Changelog -This document describes the encoding settings used by videnc version 1.0 for all video encodings. +This document tracks changes to the encoding settings used by videnc over time. -## Universal Settings +## Version 1.0 - Initial Release (2025-10-04) + +### Universal Settings These settings are applied to all videos regardless of source material: @@ -17,15 +19,15 @@ These settings are applied to all videos regardless of source material: - **film-grain-denoise**: 1 (enabled for all encodings) - **tune**: 0 (default tuning) -## Variable Settings +### Variable Settings These settings vary based on video characteristics: -### Resolution-Based Settings +#### 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 +### Source Material Dependent Settings These settings are conditionally applied based on the characteristics of the source video: @@ -38,20 +40,20 @@ These settings are conditionally applied based on the characteristics of the sou - **Keyframe Interval**: Dynamically calculated based on video FPS - Value: `Math.round(videoInfo.fps * 5)` -## Audio Settings +### 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 Settings - **Subtitle Handling**: Copy (no re-encoding) - **Language Metadata**: Preserved for each stream - **Disposition**: Finnish subtitle tracks set as default -## Metadata Handling +### Metadata Handling - **Metadata Stripping**: Original metadata is stripped (`-map_metadata -1`) - **Custom Metadata**: Added from OMDB API or user input