v18.0.0

Major

• Remove Support for Python 3.10
• Upgrade binary wheels to ffmpeg 8.1.2

Features

• Support HW encoding via a hwaccel parameter on OutputContainer.add_stream (e.g. h264_vaapi, h264_nvenc, h264_videotoolbox); software frames passed to encode are uploaded to the device automatically by @WyattBlue (#2156).
• Expose sw_format on VideoCodecContext, and allow configuring the software format of hardware encoders by @WyattBlue.
• Add options parameter to AudioResampler for passing libswresample options (e.g. resampler, filter_size, cutoff) by @WyattBlue (#2262).
• Support yuv420p10le in VideoFrame.to_ndarray and VideoFrame.from_ndarray by @WyattBlue (#1981).
• Add at parameter to Graph.push and Graph.vpush to push a frame to a single buffer source by index, for multi-input filters like overlay by @WyattBlue.
• find_best_pix_fmt_of_list now returns the loss as a PixFmtLoss enum.IntFlag instead of a plain int by @WyattBlue (#2300).
• Add Colorspace.BT2020 by @mark-oshea.
• BitStreamFilterContext now accepts a Codec or a codec-name str as in_stream to pin the input codec without a full Stream by @WyattBlue.

Fixes

• Fix VideoFrame.reformat (and to_ndarray/to_rgb/to_image) raising OSError Operation not supported on frames tagged with reserved or otherwise unsupported color_primaries/color_trc values (e.g. VP9 and NVDEC output); a transfer/primaries conversion is now only performed when explicitly requested by @WyattBlue (#2208).
• Fix add_mux_stream producing unwritable Matroska files by extracting codec extradata from the bitstream before the header is written by @WyattBlue (#2198).
• Encode GPU frames (e.g. CUDA frames from DLPack) directly with pix_fmt="cuda" by adopting the frame's hw_frames_ctx before opening the encoder by @WyattBlue (#2199).
• Fix a crash when reading VideoCodecContext.pix_fmt before it is set; it now returns None by @CarlosRDomin.
• Preserve frame attributes (pts, time_base, colorspace, etc.) when downloading hardware frames to system memory by @CarlosRDomin.

New Contributors

• @mark-oshea made their first contribution in #2325

Full Changelog: v17.1.0...v18.0.0

v17.1.0

Breaking

• Remove the undertested av.option and av.descriptor APIs, along with the related Codec and Filter descriptor accessors.

Features

• Use FFmpeg 8.1.1 in the binary wheels by @WyattBlue.
• Build Linux ARMv7 binary wheels by @WyattBlue.
• Expose AVCodecContext.global_quality by @WyattBlue in #2246.
• Expose Stream.discard so demuxing and seeking can skip unwanted streams by @WyattBlue (#2272).
• Add Stream.set_display_matrix() and Stream.set_display_rotation() to write the container display (rotation) matrix on output streams by @hmaarrfk in #2287.
• Add Container.video_codec_id to force a specific video codec on a container by @WyattBlue (#2243).

Fixes

• Add cython.final to leaf classes, ensuring that they are not subclassed by @WyattBlue.
• Warn that CodecContext.decode() is not memory safe in some cases.
• Fix memory leaks in FFmpegError, AudioLayout channel layouts, and Frame.opaque, and break a reference cycle between FilterLink and Graph by @lgeiger.
• Reduce excessive logging lock contention by @WyattBlue (#2276).
• Fix a crash when accessing Stream from multiple threads under FFmpeg 8.1 by @WyattBlue (#2247).
• Fix a crash during InputContainer initialization by @WyattBlue (#2010).
• Fix enumerate_input_devices and enumerate_output_devices raising AttributeError by @WyattBlue and @kazuki (#2264).
• Map HTTP 429 to HTTPTooManyRequestsError instead of UndefinedError by @WyattBlue (#2267).
• Fix crash in VideoFrame.to_ndarray() and to_image() on bottom-up frames with a negative line_size by @WyattBlue (#2213).
• Make Disposition an IntFlag so Stream.disposition can be assigned without raising TypeError by @HotariTobu.
• Assign parser-inferred pts, dts, and duration to packets from CodecContext.parse() by @WyattBlue (#1919).
• Copy time_base in add_stream_from_template() by @daveisfera in #2249.
• Fix the remux examples dropping keyframes that demux with no DTS, which produced audio-only output by @WyattBlue (#1917).
• Fix subtitle UTF-8 handling by @jbree in #2271.
• Fix several incorrect malloc size calculations by @WyattBlue.

New Contributors

• @HotariTobu made their first contribution in #2257
• @jbree made their first contribution in #2271
• @kazuki made their first contribution in #2288

Full Changelog: v17.0.1...v17.1.0

v17.0.1

What's Changed

• Adjust tests so they work with ffmpeg 8.1 by @strophy in #2204 and #2205
• Make VideoFormat.components lazy by @WyattBlue in #2209
• Break reference cycle in StreamContainer.get() by @lgeiger in #2221
• Expose threads in filter graph by @lgeiger in #2211
• Fix crash with container closing with GC by @WyattBlue in #2225
• Fix #2223 "Writing packets to data stream broken in av>=17" regression by @WyattBlue
• Remove _send_packet_and_recv to simplify decode() by @lgeiger in #2233
• Reuse a AVPacket read buffer when demuxing by @lgeiger in #2234
• Use AVCodecContext.frame_num instead of counting ourselves by @WyattBlue in #2236
• Use layout_compare() for AudioLayout.__eq__() by @WyattBlue in #2236

New Contributors

• @strophy made their first contribution in #2204

Full Changelog: v17.0.0...v17.0.1

v17.0.0

Major

• Limited API binary wheels are now built.
• 3.13t (free-threading) wheels are be dropped because of storage limitations. Use 3.14t or 3.13.
• When an FFmpeg C function indicates an error, raise av.ArgumentError instead of ValueError/av.ValueError. This helps disambiguate why an exception is being thrown.
• Save space by removing libaom (av1 encoder/decoder); dav1d, stvav1, and hardware, are available alternatives.

Features

• Add OutputContainer.add_mux_stream() for creating codec-context-free streams, enabling muxing of pre-encoded packets without an encoder, addressing #1970 by @WyattBlue.
• Use zero-copy for Packet init from buffer data by @WyattBlue in (#2199).
• Expose AVIndexEntry by @Queuecumber in (#2136).
• Preserving hardware memory during cuvid decoding, exporting/importing via dlpack by @WyattBlue in (#2155).
• Add enumerate_input_devices and enumerate_output_devices API by @WyattBlue in (#2174).
• Add ColorTrc and ColorPrimaries enums; add color_trc and color_primaries properties to VideoFrame; add dst_color_trc and dst_color_primaries parameters to VideoFrame.reformat(), addressing #1968 by @WyattBlue in (#2175).
• Add multithreaded reformatting and reduce Python overhead by replacing sws_scale with sws_scale_frame, skipping unnecessary reformats, and minimizing Python interactions by @lgeiger.
• Prevent data copy in VideoFrame.to_ndarray() for padded frames by @lgeiger in (#2190).

Fixes

• Fix #2149 by @WyattBlue in (#2155).
• Fix packet typing based on stream and specify InputContainer.demux based on incoming stream by @ntjohnson1 in (#2134).
• Fix memory growth when remuxing with add_stream_from_template by skipping avcodec_open2 for template-initialized codec contexts, addressing #2135 by @WyattBlue).
• Explicitly disable OpenSSL in source builds (scripts/build-deps) to prevent accidental OpenSSL linkage that breaks FIPS-enabled systems, addressing #1972.
• Add missing SWS_SPLINE interpolation by @lgeiger in (#2188).

New Contributors

• @wojiushixiaobai made their first contribution in #2076
• @ntjohnson1 made their first contribution in #2134
• @clayy24 made their first contribution in #2181

Full Changelog: v16.1.0...v17.0.0

v16.1.0

Features:

• Add support for Intel QSV codecs by @ladaapp.
• Add AMD AMF hardware decoding by @ladaapp2.
• Add subtitle encoding support by @skeskinen in #2050.
• Add read/write access to PacketSideData by @skeskinen in #2051.
• Add yuv422p support for video frame to_ndarray and from_ndarray by @wader in #2054.
• Add binding for avcodec_find_best_pix_fmt_of_list() by @ndeybach in #2058.

Fixes:

• Fix #2036, #2053, #2057 by @WyattBlue.

New Contributors

• @ndeybach made their first contribution in #2052
• @benedikt-grl made their first contribution in #2070

Full Changelog: v16.0.1...v16.1.0