PyAV-Org · WyattBlue · Jun 7, 2026 · Jun 7, 2026 · Jun 7, 2026
diff --git a/AUTHORS.rst b/AUTHORS.rst
@@ -11,117 +11,119 @@ All contributors (by number of commits):
 - Mark Reid <mindmark@gmail.com>; `@markreidvfx <https://github.com/markreidvfx>`_
 
 * Lukas Geiger <lukas.geiger94@gmail.com>
-* Vidar Tonaas Fauske <vidartf@gmail.com>; `@vidartf <https://github.com/vidartf>`_
-* laggykiller <chaudominic2@gmail.com>; `@laggykiller <https://github.com/laggykiller>`_
-* Billy Shambrook <billy.shambrook@gmail.com>; `@billyshambrook <https://github.com/billyshambrook>`_
-* Casper van der Wel <caspervdw@gmail.com>
-* Philip de Nier <philipn@rd.bbc.co.uk>
-* Tadas Dailyda <tadas@dailyda.com>
-* Dave Johansen <davejohansen@gmail.com>
-* JoeUgly <41972063+JoeUgly@users.noreply.github.com>
-* Justin Wong <46082645+uvjustin@users.noreply.github.com>
-* Mark Harfouche <mark.harfouche@gmail.com>
-* Santtu Keskinen <santtu.keskinen@gmail.com>
 
-- Alba Mendez <me@alba.sh>
-- Curtis Doty <Curtis@GreenKey.net>; `@dotysan <https://github.com/dotysan>`_
-- Xinran Xu <xxr@megvii.com>; `@xxr3376 <https://github.com/xxr3376>`_
-- z-khan <zohaibkh_27@yahoo.com>
-- Marc Mueller <30130371+cdce8p@users.noreply.github.com>
-- Dan Allan <daniel.b.allan@gmail.com>; `@danielballan <https://github.com/danielballan>`_
-- Moonsik Park <moonsik.park@estsoft.com>
-- velsinki <40809145+velsinki@users.noreply.github.com>
-- Christoph Rackwitz <christoph.rackwitz@gmail.com>
-- David Plowman <david.plowman@raspberrypi.com>
-- Alireza Davoudi <davoudialireza@gmail.com>; `@adavoudi <https://github.com/adavoudi>`_
-- Jonathan Drolet <jonathan.drolet@riedel.net>
-- Matthew Lai <m@matthewlai.ca>
-- Kim Minjong <make.dirty.code@gmail.com>
-- Moritz Kassner <moritzkassner@gmail.com>; `@mkassner <https://github.com/mkassner>`_
-- Thomas A Caswell <tcaswell@gmail.com>; `@tacaswell <https://github.com/tacaswell>`_
-- Ulrik Mikaelsson <ulrik.mikaelsson@magine.com>; `@rawler <https://github.com/rawler>`_
-- Wel C. van der <wel@Physics.LeidenUniv.nl>
-- Will Patera <willpatera@gmail.com>; `@willpatera <https://github.com/willpatera>`_
+- Vidar Tonaas Fauske <vidartf@gmail.com>; `@vidartf <https://github.com/vidartf>`_
+- laggykiller <chaudominic2@gmail.com>; `@laggykiller <https://github.com/laggykiller>`_
+- Billy Shambrook <billy.shambrook@gmail.com>; `@billyshambrook <https://github.com/billyshambrook>`_
+- Casper van der Wel <caspervdw@gmail.com>
+- Philip de Nier <philipn@rd.bbc.co.uk>
+- Tadas Dailyda <tadas@dailyda.com>
+- Dave Johansen <davejohansen@gmail.com>
+- Mark Harfouche <mark.harfouche@gmail.com>
+- JoeUgly <41972063+JoeUgly@users.noreply.github.com>
+- Justin Wong <46082645+uvjustin@users.noreply.github.com>
+- Santtu Keskinen <santtu.keskinen@gmail.com>
 
-* zzjjbb <31069326+zzjjbb@users.noreply.github.com>
-* Joe Schiff <41972063+JoeSchiff@users.noreply.github.com>
-* Nils DEYBACH <68770774+ndeybach@users.noreply.github.com>
-* Dexer <73297572+DexerBR@users.noreply.github.com>
-* DE-AI <81620697+DE-AI@users.noreply.github.com>
-* rutsh <Eugene.Krokhalev@gmail.com>
-* Felix Vollmer <FelixVollmer@gmail.com>
-* Benedikt Lorch, benedikt-grl <benedikt@getreallabs.com>
-* Santiago Castro <bryant1410@gmail.com>
-* Christian Clauss <cclauss@me.com>
-* Ihor Liubymov <ihor.liubymov@ring.com>
-* Johannes Erdfelt <johannes@erdfelt.com>
-* Karl Litterfeldt <kalle.litterfeldt@gmail.com>; `@litterfeldt <https://github.com/litterfeldt>`_
-* Leon White <l.white@interstellarlab.earth>
-* Martin Larralde <martin.larralde@ens-cachan.fr>
-* Simon-Martin Schröder <martin.schroeder@nerdluecht.de>
-* Matteo Destro <matteo.est@gmail.com>
-* Mattias Wadman <mattias.wadman@gmail.com>
-* mephi42 <mephi42@gmail.com>
-* Miles Kaufmann <mkfmnn@gmail.com>
-* Nathan Goldbaum <nathan.goldbaum@gmail.com>
-* Pablo Prietz <pablo@prietz.org>
-* Andrew Wason <rectalogic@rectalogic.com>
-* Radek Senfeld <rush@logic.cz>; `@radek-senfeld <https://github.com/radek-senfeld>`_
-* robinechuca <serveurpython.oz@gmail.com>
-* Nick <24689722+ntjohnson1@users.noreply.github.com>
-* Benjamin Chrétien <2742231+bchretien@users.noreply.github.com>
-* 吴小白 <296015668@qq.com>
-* davidplowman <38045873+davidplowman@users.noreply.github.com>
-* Hanz <40712686+HanzCEO@users.noreply.github.com>
-* Clay Castronovo <42858023+clayy24@users.noreply.github.com>
-* Kesh Ikuma <79113787+tikuma-lsuhsc@users.noreply.github.com>
-* Artturin <Artturin@artturin.com>
-* Ian Lee <IanLee1521@gmail.com>
-* Ryan Huang <NPN@users.noreply.github.com>
-* Arthur Barros <arthbarros@gmail.com>
-* bdavid-evertz <bdavid@evertz.com>
-* Carlos Ruiz <carlos.r.domin@gmail.com>
-* Carlos Ruiz <carlos.ruiz.dominguez@west.cmu.edu>
-* Maxime Desroches <desroches.maxime@gmail.com>
-* egao1980 <egao1980@gmail.com>
-* Eric Kalosa-Kenyon <ekalosak@gmail.com>
-* elxy <elxy@outlook.com>
-* Gemfield <gemfield@civilnet.cn>
-* henri-gasc <henri.gasc@eurecom.fr>
-* Jonathan Martin <homerunisgood@hotmail.com>
-* HotariTobu <hotari24tools@gmail.com>
-* Joshua <jbree@users.noreply.github.com>
-* Johan Jeppsson Karlin <johjep@gmail.com>
-* Kian-Meng Ang <kianmeng@cpan.org>
-* Philipp Klaus <klaus@physik.uni-frankfurt.de>
-* Marcell Pardavi <marcell.pardavi@gmail.com>
-* Matteo Destro <matteo@cerrion.com>
-* Max Ehrlich <max.ehr@gmail.com>
-* Manuel Goacolou <mgoacolou@cls.fr>
-* Julian Schweizer <neuneck@gmail.com>
-* Nikhil Idiculla <nikhilidiculla@gmail.com>
-* Ömer Sezgin Uğurlu <omer@ugurlu.org>
-* Orivej Desh <orivej@gmx.fr>
-* Philipp Krähenbühl <philkr@users.noreply.github.com>
-* Mattia Procopio <promat85@gmail.com>
-* Max Ehrlich <queuecumber@protonmail.com>
-* ramoncaldeira <ramoncaldeira_328@hotmail.com>
-* Roland van Laar <roland@rolandvanlaar.nl>
-* Santiago Castro <sacastro@umich.edu>
-* Kengo Sawatsu <seattleserv0@gmail.com>
-* FirefoxMetzger <sebastian@wallkoetter.net>
-* hyenal <sebastien.ehrhardt@gmail.com>
-* Brendan Long <self@brendanlong.com>; `@brendanlong <https://github.com/brendanlong>`_
-* Семён Марьясин <simeon@maryasin.name>
-* Stephen.Y <stepheny@users.noreply.github.com>
-* Tom Flanagan <theknio@gmail.com>
-* Tim O'Shea <tim.oshea753@gmail.com>
-* Tim Ahpee <timah@blackmagicdesign.com>
-* Jonas Tingeborn <tinjon@gmail.com>
-* Pino Toscano <toscano.pino@tiscali.it>
-* Ulrik Mikaelsson <ulrikm@spotify.com>
-* Vasiliy Kotov <vasiliy.kotov@itechart-group.com>
-* Koichi Akabe <vbkaisetsu@gmail.com>
-* David Joy <videan42@gmail.com>
-* Sviatoslav Sydorenko (Святослав Сидоренко) <webknjaz@redhat.com>
-* Jiabei Zhu <zjb@bu.edu>
+* Alba Mendez <me@alba.sh>
+* Curtis Doty <Curtis@GreenKey.net>; `@dotysan <https://github.com/dotysan>`_
+* Xinran Xu <xxr@megvii.com>; `@xxr3376 <https://github.com/xxr3376>`_
+* z-khan <zohaibkh_27@yahoo.com>
+* Marc Mueller <30130371+cdce8p@users.noreply.github.com>
+* Dan Allan <daniel.b.allan@gmail.com>; `@danielballan <https://github.com/danielballan>`_
+* Moonsik Park <moonsik.park@estsoft.com>
+* velsinki <40809145+velsinki@users.noreply.github.com>
+* Christoph Rackwitz <christoph.rackwitz@gmail.com>
+* David Plowman <david.plowman@raspberrypi.com>
+* Alireza Davoudi <davoudialireza@gmail.com>; `@adavoudi <https://github.com/adavoudi>`_
+* Jonathan Drolet <jonathan.drolet@riedel.net>
+* Matthew Lai <m@matthewlai.ca>
+* Kim Minjong <make.dirty.code@gmail.com>
+* Moritz Kassner <moritzkassner@gmail.com>; `@mkassner <https://github.com/mkassner>`_
+* Thomas A Caswell <tcaswell@gmail.com>; `@tacaswell <https://github.com/tacaswell>`_
+* Ulrik Mikaelsson <ulrik.mikaelsson@magine.com>; `@rawler <https://github.com/rawler>`_
+* Wel C. van der <wel@Physics.LeidenUniv.nl>
+* Will Patera <willpatera@gmail.com>; `@willpatera <https://github.com/willpatera>`_
+
+- zzjjbb <31069326+zzjjbb@users.noreply.github.com>
+- Joe Schiff <41972063+JoeSchiff@users.noreply.github.com>
+- Nils DEYBACH <68770774+ndeybach@users.noreply.github.com>
+- Dexer <73297572+DexerBR@users.noreply.github.com>
+- DE-AI <81620697+DE-AI@users.noreply.github.com>
+- rutsh <Eugene.Krokhalev@gmail.com>
+- Felix Vollmer <FelixVollmer@gmail.com>
+- Benedikt Lorch, benedikt-grl <benedikt@getreallabs.com>
+- Santiago Castro <bryant1410@gmail.com>
+- Christian Clauss <cclauss@me.com>
+- Ihor Liubymov <ihor.liubymov@ring.com>
+- Johannes Erdfelt <johannes@erdfelt.com>
+- Karl Litterfeldt <kalle.litterfeldt@gmail.com>; `@litterfeldt <https://github.com/litterfeldt>`_
+- Leon White <l.white@interstellarlab.earth>
+- Martin Larralde <martin.larralde@ens-cachan.fr>
+- Simon-Martin Schröder <martin.schroeder@nerdluecht.de>
+- Matteo Destro <matteo.est@gmail.com>
+- Mattias Wadman <mattias.wadman@gmail.com>
+- mephi42 <mephi42@gmail.com>
+- Miles Kaufmann <mkfmnn@gmail.com>
+- Nathan Goldbaum <nathan.goldbaum@gmail.com>
+- Pablo Prietz <pablo@prietz.org>
+- Andrew Wason <rectalogic@rectalogic.com>
+- Radek Senfeld <rush@logic.cz>; `@radek-senfeld <https://github.com/radek-senfeld>`_
+- robinechuca <serveurpython.oz@gmail.com>
+- Nick <24689722+ntjohnson1@users.noreply.github.com>
+- Benjamin Chrétien <2742231+bchretien@users.noreply.github.com>
+- 吴小白 <296015668@qq.com>
+- davidplowman <38045873+davidplowman@users.noreply.github.com>
+- Hanz <40712686+HanzCEO@users.noreply.github.com>
+- Clay Castronovo <42858023+clayy24@users.noreply.github.com>
+- Kesh Ikuma <79113787+tikuma-lsuhsc@users.noreply.github.com>
+- Artturin <Artturin@artturin.com>
+- Ian Lee <IanLee1521@gmail.com>
+- Ryan Huang <NPN@users.noreply.github.com>
+- Arthur Barros <arthbarros@gmail.com>
+- bdavid-evertz <bdavid@evertz.com>
+- Carlos Ruiz <carlos.r.domin@gmail.com>
+- Carlos Ruiz <carlos.ruiz.dominguez@west.cmu.edu>
+- Maxime Desroches <desroches.maxime@gmail.com>
+- egao1980 <egao1980@gmail.com>
+- Eric Kalosa-Kenyon <ekalosak@gmail.com>
+- elxy <elxy@outlook.com>
+- Gemfield <gemfield@civilnet.cn>
+- henri-gasc <henri.gasc@eurecom.fr>
+- Jonathan Martin <homerunisgood@hotmail.com>
+- HotariTobu <hotari24tools@gmail.com>
+- Joshua <jbree@users.noreply.github.com>
+- Johan Jeppsson Karlin <johjep@gmail.com>
+- Kazuki Oikawa <k@oikw.org>
+- Kian-Meng Ang <kianmeng@cpan.org>
+- Philipp Klaus <klaus@physik.uni-frankfurt.de>
+- Marcell Pardavi <marcell.pardavi@gmail.com>
+- Matteo Destro <matteo@cerrion.com>
+- Max Ehrlich <max.ehr@gmail.com>
+- Manuel Goacolou <mgoacolou@cls.fr>
+- Julian Schweizer <neuneck@gmail.com>
+- Nikhil Idiculla <nikhilidiculla@gmail.com>
+- Ömer Sezgin Uğurlu <omer@ugurlu.org>
+- Orivej Desh <orivej@gmx.fr>
+- Philipp Krähenbühl <philkr@users.noreply.github.com>
+- Mattia Procopio <promat85@gmail.com>
+- Max Ehrlich <queuecumber@protonmail.com>
+- ramoncaldeira <ramoncaldeira_328@hotmail.com>
+- Roland van Laar <roland@rolandvanlaar.nl>
+- Santiago Castro <sacastro@umich.edu>
+- Kengo Sawatsu <seattleserv0@gmail.com>
+- FirefoxMetzger <sebastian@wallkoetter.net>
+- hyenal <sebastien.ehrhardt@gmail.com>
+- Brendan Long <self@brendanlong.com>; `@brendanlong <https://github.com/brendanlong>`_
+- Семён Марьясин <simeon@maryasin.name>
+- Stephen.Y <stepheny@users.noreply.github.com>
+- Tom Flanagan <theknio@gmail.com>
+- Tim O'Shea <tim.oshea753@gmail.com>
+- Tim Ahpee <timah@blackmagicdesign.com>
+- Jonas Tingeborn <tinjon@gmail.com>
+- Pino Toscano <toscano.pino@tiscali.it>
+- Ulrik Mikaelsson <ulrikm@spotify.com>
+- Vasiliy Kotov <vasiliy.kotov@itechart-group.com>
+- Koichi Akabe <vbkaisetsu@gmail.com>
+- David Joy <videan42@gmail.com>
+- Sviatoslav Sydorenko (Святослав Сидоренко) <webknjaz@redhat.com>
+- Jiabei Zhu <zjb@bu.edu>
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -25,21 +25,36 @@ We are operating with `semantic versioning <https://semver.org>`_.
     - Bug fixes (PATCH) go here. 
     - $CHANGE by :gh-user:`mikeboers` in (:pr:`1`).
 
-v17.1.0 (next)
---------------
+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.
+- Use FFmpeg 8.1.1 in the binary wheels by :gh-user:`WyattBlue`.
+- Build Linux ARMv7 binary wheels by :gh-user:`WyattBlue`.
 - Expose ``AVCodecContext.global_quality`` by :gh-user:`WyattBlue` in (:pr:`2246`).
-- Expose ``Stream.discard`` so demuxing and seeking can skip unwanted streams (:issue:`2272`).
+- Expose ``Stream.discard`` so demuxing and seeking can skip unwanted streams by :gh-user:`WyattBlue` (:issue:`2272`).
 - Add ``Stream.set_display_matrix()`` and ``Stream.set_display_rotation()`` to write the container display (rotation) matrix on output streams by :gh-user:`hmaarrfk` in (:pr:`2287`).
+- Add ``Container.video_codec_id`` to force a specific video codec on a container by :gh-user:`WyattBlue` (:issue:`2243`).
 
 Fixes:
-- Add ``cython.final`` to leaf classes, ensuring that they are not subclassed.
+- Add ``cython.final`` to leaf classes, ensuring that they are not subclassed by :gh-user:`WyattBlue`.
 - Warn that ``CodecContext.decode()`` is not memory safe in some cases.
-- Fix ``enumerate_input_devices`` and ``enumerate_output_devices`` raising ``AttributeError`` (:issue:`2264`).
-- Map HTTP 429 to ``HTTPTooManyRequestsError`` instead of ``UndefinedError`` (:issue:`2267`).
-- Fix crash in ``VideoFrame.to_ndarray()`` and ``to_image()`` on bottom-up frames with a negative ``line_size`` (:issue:`2213`).
+- Fix memory leaks in ``FFmpegError``, ``AudioLayout`` channel layouts, and ``Frame.opaque``, and break a reference cycle between ``FilterLink`` and ``Graph`` by :gh-user:`lgeiger`.
+- Reduce excessive logging lock contention by :gh-user:`WyattBlue` (:issue:`2276`).
+- Fix a crash when accessing ``Stream`` from multiple threads under FFmpeg 8.1 by :gh-user:`WyattBlue` (:issue:`2247`).
+- Fix a crash during ``InputContainer`` initialization by :gh-user:`WyattBlue` (:issue:`2010`).
+- Fix ``enumerate_input_devices`` and ``enumerate_output_devices`` raising ``AttributeError`` by :gh-user:`WyattBlue` and :gh-user:`kazuki` (:issue:`2264`).
+- Map HTTP 429 to ``HTTPTooManyRequestsError`` instead of ``UndefinedError`` by :gh-user:`WyattBlue` (:issue:`2267`).
+- Fix crash in ``VideoFrame.to_ndarray()`` and ``to_image()`` on bottom-up frames with a negative ``line_size`` by :gh-user:`WyattBlue` (:issue:`2213`).
+- Make ``Disposition`` an ``IntFlag`` so ``Stream.disposition`` can be assigned without raising ``TypeError`` by :gh-user:`HotariTobu`.
+- Assign parser-inferred ``pts``, ``dts``, and ``duration`` to packets from ``CodecContext.parse()`` by :gh-user:`WyattBlue` (:issue:`1919`).
+- Copy ``time_base`` in ``add_stream_from_template()`` by :gh-user:`daveisfera` in (:pr:`2249`).
+- Fix the remux examples dropping keyframes that demux with no DTS, which produced audio-only output by :gh-user:`WyattBlue` (:issue:`1917`).
+- Fix subtitle UTF-8 handling by :gh-user:`jbree` in (:pr:`2271`).
+- Fix several incorrect ``malloc`` size calculations by :gh-user:`WyattBlue`.
 
 v17.0.1
 -------

diff --git a/av/about.py b/av/about.py
@@ -1 +1 @@
-__version__ = "17.1.0pre"
+__version__ = "17.1.0"