video-converter/FFMPEG_NOTES.md

FFmpeg Configuration Notes for Video Converter Project

This document details the ffmpeg settings and considerations used within the Video Converter project, especially concerning DaVinci Resolve compatibility.

Current Default Conversion Settings (as of 2025-10-31)

The project currently uses the following ffmpeg settings for converting video files to DaVinci Resolve compatible formats (Free Linux version, targeting 1080p60 and 1440p60):

• Video Codec: dnxhd (DNxHD/HR)
  • Profile for 1080p (<=1080 height): dnxhr_hq (DNxHR High Quality)
  • Profile for 1440p (>1080 height): dnxhr_hqx (DNxHR High Quality X)
  • Pixel Format: yuv422p (4:2:2 chroma subsampling, 8-bit) - Note: The dnxhr_hq and dnxhr_hqx profiles inherently imply 10-bit where applicable, but yuv422p is a common base.
• Audio Codec: pcm_s16le (Linear PCM, 16-bit signed little-endian)
• Container: .mov (QuickTime)

Example ffmpeg Command Structure (simplified):

ffmpeg -i input.mp4 -c:v dnxhd -profile:v dnxhr_hqx -pix_fmt yuv422p -c:a pcm_s16le output.mov

Rationale for Choices:

• dnxhd codec: Chosen for its excellent compatibility and performance as an intermediate editing codec in DaVinci Resolve, especially on Linux. It provides high quality and is an intraframe codec.
• dnxhr_hq / dnxhr_hqx profiles: Selected to ensure high-quality output suitable for professional editing, balancing file size and visual fidelity. dnxhr_hqx offers even higher quality for higher resolutions.
• pcm_s16le audio: Used to avoid known compatibility issues with AAC audio in DaVinci Resolve on Linux, ensuring reliable audio playback. PCM is uncompressed and lossless.
• .mov container: Recommended for its robustness and better metadata handling with DaVinci Resolve for intermediate files.

Alternative Approaches / Future Considerations:

• ProRes: While ffmpeg can encode ProRes, its use on Linux with DaVinci Resolve Free might be limited or require specific ffmpeg builds/licenses. It could be an alternative if dnxhd proves problematic or if a user specifically requests it.
• High-Quality H.264/H.265: For scenarios where file size is a primary concern and editing performance is secondary (e.g., proxy generation or final delivery), high-bitrate H.264/H.265 could be considered. However, these are interframe codecs and generally less ideal for direct editing.
• Pixel Format: Further investigation into yuv422p10le (10-bit 4:2:2) might be warranted if the source is 10-bit and the target Davinci Resolve version fully supports it for dnxhd in the free version.

---

Document generated by Gemini CLI Agent.