Repository navigation
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_streamsmetadata key, reporting the number of embedded video streams. - Added
source_video_attached_picsmetadata key, listing per-type indexes of cover art (attached picture) streams. - Added
source_video_sarandsource_video_darmetadata keys, reporting sample and display aspect ratios. - Added
source_video_color_range,source_video_color_space,source_video_color_primaries, andsource_video_color_transfermetadata keys. - Added
source_start_secmetadata key, reporting source start time.
- Added
- FFdecoder:
- Added automated warnings for sources with non-square pixels or HDR transfer profiles, recommending suitable
-vffilters.
- Added automated warnings for sources with non-square pixels or HDR transfer profiles, recommending suitable
⚡️ 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_complexusing a single[0:v:N]input now sets the video stream index toN(unindexed[0:v]counts as0).- Optional
-map 0:v:N?now sets the video stream index toNas well. - Stream selection via
-map 0:v:Nor-filter_complexnow correctly wins over a conflicting-default_stream_indexesvideo 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 stream0).
- Added warning on out-of-range
- Maintenance & Tests:
- Hardened
prepare_dataset.shscript to abort on first error, support.7z/zip/tar.*archives, and bump default FFmpeg alt binaries date to08-11-2026. - Significantly expanded test coverage across aspect ratios, color profiles, start times, filters, multi-stream selection, orientation parsing, and rotation handling.
- Hardened
- 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_pixfmtmetadata 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_patchon non-8-bit YUV pixel formats. - Fixed
-default_stream_indexesvideo index failing to select the decoded stream for single sources. - Fixed wrong output size with
-vfon multi-stream sources and ±90° rotated sources getting squeezed back into coded size incorrectly.
- Fixed corrupt frames when using filters without an explicit
- Sourcer:
- Fixed empty
source_audio_bitrateparsing for non-fltpcodecs. - Fixed
source_duration_secreporting0for sources of 24 hours or longer. - Fixed
source_video_orientationfailing on FFmpeg 8.1+ due to side-data label renaming. - Fixed rotation pairing issues, relative
.mpdmanifest paths, output metadata reading from auxiliary streams, and multi-program MPEG-TS duplicate stream counts.
- Fixed empty
You can become a sponsor via GitHub Sponsors by clicking the button below:
Thanks a million! 😊