Skip to content

v0.3.0

Latest

Choose a tag to compare

@abhiTronix abhiTronix released this 10 Nov 16:50

Summary:

This release introduces comprehensive Sourcer metadata enhancements for embedded streams, aspect ratios, color properties, and start times, alongside powerful FFdecoder stream-selection controls, multi-stream safeguards, HDR/anamorphic filters, extensive test coverage expansion, and crucial bug fixes across decoding and metadata parsing pipelines.

Full Changelog: https://abhitronix.github.io/deffcode/latest/changelog/#v030-2026-11-10


What's Changed

✨ New Features

  • Sourcer:
    • Added source_video_streams metadata key, reporting the number of embedded video streams.
    • Added source_video_attached_pics metadata key, listing per-type indexes of cover art (attached picture) streams.
    • Added source_video_sar and source_video_dar metadata keys, reporting sample and display aspect ratios.
    • Added source_video_color_range, source_video_color_space, source_video_color_primaries, and source_video_color_transfer metadata keys.
    • Added source_start_sec metadata key, reporting source start time.
  • FFdecoder:
    • Added automated warnings for sources with non-square pixels or HDR transfer profiles, recommending suitable -vf filters.

⚡️ Updates/Improvements

  • FFdecoder:
    • Multi-stream sources without a selection now decode the first real video stream (with a warning) instead of FFmpeg's auto-selected high-level rendition.
    • -filter_complex using a single [0:v:N] input now sets the video stream index to N (unindexed [0:v] counts as 0).
    • Optional -map 0:v:N? now sets the video stream index to N as well.
    • Stream selection via -map 0:v:N or -filter_complex now correctly wins over a conflicting -default_stream_indexes video index.
    • Filtergraph outputs without fixed framerate now output at the selected stream's framerate or user-defined -framerate (-r).
  • Sourcer:
    • Added warning on out-of-range default_stream_indexes (falling back to stream 0).
  • Maintenance & Tests:
    • Hardened prepare_dataset.sh script to abort on first error, support .7z/zip/tar.* archives, and bump default FFmpeg alt binaries date to 08-11-2026.
    • Significantly expanded test coverage across aspect ratios, color profiles, start times, filters, multi-stream selection, orientation parsing, and rotation handling.
  • Docs:
    • Added new recipes for decoding anamorphic and HDR files, handling multi-stream setups, and documenting advanced filters and stream indexing.

💥 Breaking Updates/Changes

  • None in this release.

🐛 Bug-fixes

  • FFdecoder:
    • Fixed corrupt frames when using filters without an explicit frame_format.
    • Fixed output_frames_pixfmt metadata reporting source pixel-format instead of decoded format when no filters are defined.
    • Fixed degraded quality of frames resized by filters (avoiding redundant secondary scaling).
    • Fixed misaligned frames with -extract_luma/-enforce_cv_patch on non-8-bit YUV pixel formats.
    • Fixed -default_stream_indexes video index failing to select the decoded stream for single sources.
    • Fixed wrong output size with -vf on multi-stream sources and ±90° rotated sources getting squeezed back into coded size incorrectly.
  • Sourcer:
    • Fixed empty source_audio_bitrate parsing for non-fltp codecs.
    • Fixed source_duration_sec reporting 0 for sources of 24 hours or longer.
    • Fixed source_video_orientation failing on FFmpeg 8.1+ due to side-data label renaming.
    • Fixed rotation pairing issues, relative .mpd manifest paths, output metadata reading from auxiliary streams, and multi-program MPEG-TS duplicate stream counts.

You can become a sponsor via GitHub Sponsors by clicking the button below:

Thanks a million! 😊