Changelog

1.14.0

  • Allow MediaRecorder to record audio and / or video to a WebM container.

  • Restore support for calling RTCPeerConnection.addIceCandidate() before RTCPeerConnection.setRemoteDescription().

  • Send a keyframe if an RTCP Full Instantaneous Resolution (FIR) feedback is received.

  • Support parsing SDP rtcp attribute without a host.

  • Use the “modern” SDP form “UDP/DTLS/SCTP” in offers to negotiate data channels.

  • Relax versioned dependency on PyAV to allow version 15.x and 16.x.

  • Add support for Python 3.14, drop end-of-life Python 3.9.

1.13.0

  • Add support for G.722 audio codec.

  • Handle undecodable VP8 packages as was done prior to release 1.12.0.

  • Limit the number of threads used for VP8 encoding as was done prior to release 1.12.0.

  • Allow calling RTCPeerConnection.setLocalDescription() with no argument to implicitly create an offer or answer as needed.

  • Allow calling RTCPeerConnection.addIceCandidate() with None argument to signal remote end-of-candidates.

  • Support creating offers without media or data channels.

  • Reject STUN URLs containing a “transport” query parameter.

  • Ensure the webcam example shuts down cleanly on KeyboardInterrupt.

1.12.0

  • Use PyAV to perform Opus + VP8 encoding and decoding. This means aiortc is now pure Python.

  • Allow configuring the media-bundling policy using RTCConfiguration.bundlePolicy.

  • Fix reversed track negotiated media ID (mid) when using multiple transceivers of the same kind.

  • Fix the RTCIceServer.urls typing to accept List[str] in addition to str.

  • Fix octet count and packet count overflow in RTCRtpSender when sending RTCP sender reports.

  • Fix RTCPeerConnection.addIceCandidate() when handling candidates with and m-line index and no media ID.

1.11.0

  • Fix decoding of RTX retransmission packets.

  • Drop support for obsolete h264_omx codec.

  • Require PyAV 14.x to support recent FFmpeg versions.

  • Require pyee 13.x for better typing support.

  • Require pyOpenSSL 25.x and fix deprecation warnings.

1.10.1

  • Build wheels for Linux aarch64 again.

  • Be more cautious when releasing RTCRtpSender’s encoder.

  • Set correct codec for MediaRecorder OGG output.

1.10.0

  • Add support for Python 3.13, drop end-of-life Python 3.8.

  • Stop building wheels for Linux aarch64 for now due to CI instability.

  • Add py.typed to indicate the package has typings, fix some annotations.

  • Avoid early wraparound of RTP sequences numbers which can break SRTP.

  • Add support for sha-384 and sha-512 DTLS certificate fingerprints.

  • Allow using PyAV 13.x.

1.9.0

  • Handle offers with active or passive DTLS setups.

  • Stop using the deprecated audioop standard library module.

  • Allow using PyAV 12.x.

1.8.0

1.7.0

  • Add support for GCM based SRTP protection profiles.

  • Reduce supported DTLS cipher list to avoid Client Hello fragmentation.

  • Fix utcnow() deprecation warning on Python 3.12.

1.6.0

  • Build wheels using Py_LIMITED_ABI to make them compatible with future Python versions.

  • Build wheels using opus 1.4 and vpx 1.13.1.

  • Use unique IDs for audio and video header extensions.

  • Allow MediaRecorder to record audio from pulse.

1.5.0

  • Make H.264 send a full picture when picture loss occurs.

  • Fix TURN over TCP by updating aioice to 0.9.0.

  • Make use of the ifaddr package instead of the unmaintained netifaces package.

1.4.0

1.3.2

  • Limit size of NACK reports to avoid excessive packet size.

  • Improve H.264 codec matching.

  • Determine video size from first frame received by MediaRecorder.

  • Fix a deprecation warning when using av >= 9.1.0.

  • Tolerate STUN URLs containing a protocol querystring argument.

1.3.1

  • Build wheels for aarch64 on Linux.

  • Adapt MediaPlayer for PyAV 9.x.

  • Ensure H.264 produces B-frames by resetting picture type.

1.3.0

  • Build wheels for Python 3.10 and for arm64 on Mac.

  • Build wheels against libvpx 1.10.

  • Add support for looping in MediaPlayer.

  • Add unbuffered option to MediaRelay.

  • Calculate audio energy and send in RTP header extension.

  • Fix a race condition in RTP sender/receiver shutdown.

  • Improve performance of H.264 bitstream splitting code.

  • Update imports for pyee version 9.x.

  • Fully switch to google-crc32c instead of crc32.

  • Drop support for Python 3.6.

  • Remove apprtc code as the service is no longer publicly hosted.

1.2.1

  • Add a clear error message when no common codec is found.

  • Replace the crc32 dependency with google-crc32c which offers a more liberal license.

1.2.0

  • Fix jitter buffer to avoid severe picture corruption under packet loss and send Picture Loss Indication (PLI) when needed.

  • Make H.264 encoder honour the bitrate from the bandwidth estimator.

  • Add support for hardware-accelerated H.264 encoding on Raspberry Pi 4 using the h264_omx codec.

  • Add MediaRelay class to allow sending media tracks to multiple consumers.

1.1.2

  • Add RTCPeerConnection.connectionState property.

  • Correctly detect RTCIceTransport “failed” state.

  • Correctly route RTP packets when there are multiple tracks of the same kind.

  • Use full module name to name loggers.

1.1.1

  • Defer adding remote candidates until after transport bundling to avoid unnecessary mDNS lookups.

1.1.0

  • Add support for resolving mDNS candidates.

  • Improve support for TURN, especially long-lived connections.

1.0.0

Breaking

Media

  • Handle SSRC attributes in SDP containing a colon (#372).

  • Limit number of H.264 NALU per packet (#394, #426).

Examples

  • server make it possible to specify bind address (#347).

0.9.28

Provide binary wheels for Linux, Mac and Windows on PyPI.

0.9.27

Data channels

Media

0.9.26

DTLS

  • Drop support for OpenSSL < 1.0.2.

Examples

  • apprtc fix handling of empty “candidate” message.

Media

  • Fix a MediaPlayer crash when stopping one track of a multi-track file (#237, #274).

  • Fix a MediaPlayer error when stopping a track while waiting for the next frame.

  • Make RTCRtpSender resilient to exceptions raised by media stream tracks (#283).

0.9.25

Media

  • Do not repeatedly send key frames after receiving a PLI.

SDP

  • Do not try to determine track ID if there is no Msid.

  • Accept a star in rtcp-fb attributes.

0.9.24

Peer connection

  • Assign DTLS role based on the SDP negotiation, not the resolved ICE role.

  • When the peer is ICE lite, adopt the ICE controlling role, and do not use agressive nomination.

  • Do not close transport on setRemoteDescription if media and data are bundled.

  • Set RemoteStreamTrack.id based on the Msid.

Media

  • Support alsa hardware output in MediaRecorder.

SDP

  • Add support for the ice-lite attribute.

  • Add support for receiving session-level ice-ufrag, ice-pwd and setup attributes.

Miscellaneous

  • Switch from attrs to standard Python dataclasses.

  • Use PEP-526 style variable annotations instead of comments.

0.9.23

  • Drop support for Python 3.5.

  • Drop dependency on PyOpenSSL.

  • Use PyAV >= 7.0.0.

  • Add partial type hints.

0.9.22

DTLS

  • Display exception if data handler fails.

Examples

  • server and webcam : add playsinline attribute for iOS compatibility.

  • webcam : make it possible to play media from a file.

Miscellaneous

  • Use aioice >= 0.6.15 to not fail on mDNS candidates.

  • Use pyee version 6.x.

0.9.21

DTLS

  • Call SSL_CTX_set_ecdh_auto for OpenSSL 1.0.2.

Media

Examples

  • MediaPlayer : release resources (e.g. webcam) when the player stops.

  • ApprtcSignaling : make AppRTC signaling available for more examples.

  • datachannel-cli : make uvloop optional.

  • videostream-cli : animate the flag with a wave effect.

  • webcam : explicitly set frame rate to 30 fps for webcams.

0.9.20

Data channels

  • Support out-of-band negotiation and custom channel id.

Documentation

  • Fix documentation build by installing crc32c instead of crcmod.

Examples

  • MediaPlayer : skip frames with no presentation timestamp (pts).

0.9.19

Data channels

  • Do not raise congestion window when it is not fully utilized.

  • Fix Highest TSN Newly Acknowledged logic for striking lost chunks.

  • Do not limit congestion window to 120kB, limit burst size instead.

Media

  • Skip RTX packets with an empty payload.

Examples

  • apprtc : make the initiator send messages using an HTTP POST instead of WebSocket.

  • janus : new example to connect to the Janus WebRTC server.

  • server : add cartoon effect to video transforms.

0.9.18

DTLS

  • Do not use DTLSv1_get_timeout after DTLS handshake completes.

Data channels

  • Add setter for RTCDataChannel.bufferedAmountLowThreshold.

  • Use crc32c package instead of crcmod, it provides better performance.

  • Improve parsing and serialization code performance.

  • Disable logging code if it is not used to improve performance.

0.9.17

DTLS

  • Do not bomb if SRTP is received before DTLS handshake completes.

Data channels

  • Implement unordered delivery, so that the ordered option is honoured.

  • Implement partial reliability, so that the maxRetransmits and maxPacketLifeTime options are honoured.

Media

  • Put all tracks in the same stream for now, fixes breakage introduced in 0.9.14.

  • Use case-insensitive comparison for codec names.

  • Use a=msid attribute in SDP instead of SSRC-level attributes.

Examples

  • server : make it possible to select unreliable mode for data channels.

  • server : print the round-trip time for data channel messages.

0.9.16

DTLS

  • Log OpenSSL errors if the DTLS handshake fails.

  • Fix DTLS handshake in server mode with OpenSSL < 1.1.0.

Media

Examples

  • server : make it possible to force audio codec.

  • server : shutdown cleanly on Chrome which lacks RTCRtpTransceiver.stop().

0.9.15

Data channels

  • Emit a warning if the crcmod C extension is not present.

Media

  • Support subsequent offer / answer exchanges.

  • Route RTCP parameters to RTP receiver and sender independently.

  • Fix a regression when the remote SSRC are not known.

  • Fix VP8 descriptor parsing errors detected by fuzzing.

  • Fix H264 descriptor parsing errors detected by fuzzing.

0.9.14

Media

  • Add support for RTX retransmission packets.

  • Fix RTP and RTCP parsing errors detected by fuzzing.

  • Use case-insensitive comparison for hash algorithm in SDP, fixes interoperability with Asterisk.

  • Offer NACK PLI and REMB feedback mechanisms for H.264.

0.9.13

Data channels

  • Raise an exception if RTCDataChannel.send() is called when readyState is not ‘open’.

  • Do not use stream sequence number for unordered data channels.

Media

  • Set VP8 target bitrate according to Receiver Estimated Maximum Bandwidth.

Examples

  • Correctly handle encoding in copy-and-paste signaling.

  • server : add command line options to use HTTPS.

  • webcam : add command line options to use HTTPS.

  • webcam : add code to open webcam on OS X.

0.9.12

  • Rework code in order to facilitate garbage collection and avoid memory leaks.

0.9.11

Media

  • Make AudioStreamTrack and VideoStreamTrack produce empty frames more regularly.

Examples

  • Fix a regession in copy-and-paste signaling which blocked the event loop.

0.9.10

Peer connection

  • Send raddr and rport parameters for server reflexive and relayed candidates. This is required for Firefox to accept our STUN / TURN candidates.

  • Do not raise an exception if ICE or DTLS connection fails, just change state.

Media

  • Revert to using asyncio’s run_in_executor to send data to the encoder, it greatly reduces the response time.

  • Adjust package requirements to accept PyAV < 7.0.0.

Examples

  • webcam : force Chrome to use “unified-plan” semantics to enabled addTransceiver.

  • MediaPlayer : don’t sleep at all when playing from webcam. This eliminates the constant one-second lag in the webcam demo.

0.9.9

Warning

aiortc now uses PyAV’s AudioFrame and VideoFrame classes instead of defining its own.

Media

Examples

0.9.8

Media

  • Add support for H.264 video, a big thank you to @dsvictor94!

  • Add support for sending Receiver Estimate Maximum Bitrate (REMB) feedback.

  • Add support for parsing / serializing more RTP header extensions.

  • Move each media encoder / decoder its one thread instead of using a thread pool.

Statistics

Examples

0.9.7

Media

  • Make RemoteStreamTrack emit an “ended” event, to simplify shutting down media consumers.

  • Add RemoteStreamTrack.readyState property.

  • Handle timestamp wraparound on sent RTP packets.

Packaging

  • Add a versioned dependency on cffi>=1.0.0 to fix Raspberry Pi builds.

0.9.6

Data channels

  • Optimize reception for improved latency and throughput.

Media

Examples

  • datachannel-cli: display ping/pong roundtrip time.

0.9.5

Media

  • Make it possible to add multiple audio or video streams.

  • Implement basic RTP video packet loss detection / retransmission using RTCP NACK feedback.

  • Respond to Picture Loss Indications (PLI) by sending a keyframe.

  • Use shorter MID values to reduce RTP header extension overhead.

  • Correctly shutdown and discard unused transports when using BUNDLE.

Examples

  • server : make it possible to save received video to an AVI file.

0.9.4

Peer connection

  • Add support for TURN over TCP.

Examples

  • Add media and signaling helpers in aiortc.contrib.

  • Fix colorspace OpenCV colorspace conversions.

  • apprtc : send rotating image on video track.

0.9.3

Media

  • Set PictureID attribute on outgoing VP8 frames.

  • Negotiate and send SDES MID header extension for RTP packets.

  • Fix negative packets_lost encoding for RTCP reports.

0.9.2

Data channels

  • Numerous performance improvements in congestion control.

Examples

  • datachannel-filexfer: use uvloop instead of default asyncio loop.

0.9.1

Data channels

  • Revert making RTCDataChannel.send a coroutine.

0.9.0

Media

  • Enable post-processing in VP8 decoder to remove (macro) blocks.

  • Set target bitrate for VP8 encoder to 900kbps.

  • Re-create VP8 encoder if frame size changes.

  • Implement jitter estimation for RTCP reports.

  • Avoid overflowing the DLSR field for RTCP reports.

  • Raise video jitter buffer size.

Data channels

  • BREAKING CHANGE: make RTCDataChannel.send a coroutine.

  • Support spec-compliant SDP format for datachannels, as used in Firefox 63.

  • Never send a negative advertised_cwnd.

Examples

  • datachannel-filexfer: new example for file transfer over a data channel.

  • datachannel-vpn: new example for a VPN over a data channel.

  • server: make it possible to select video resolution.

0.8.0

Media

  • Align VP8 settings with those used by WebRTC project, which greatly improves video quality.

  • Send RTCP source description, sender report, receiver report and bye packets.

Examples

  • server:

    • make it possible to not transform video at all.

    • allow video display to be up to 1280px wide.

  • videostream-cli:

    • fix Python 3.5 compatibility

Miscellaneous

  • Delay logging string interpolation to reduce cost of packet logging in non-verbose mode.

0.7.0

Peer connection

Media

Data channels

  • Clean up RTCDataChannel shutdown sequence.

  • Support receiving an SCTP RE-CONFIG to raise number of inbound streams.

Examples

  • server:

    • perform some image processing using OpenCV.

    • make it possible to disable data channels.

    • make demo web interface more mobile-friendly.

  • apprtc:

    • automatically create a room if no room is specified on command line.

    • handle bye command.

0.6.0

Peer connection

  • Make it possible to specify one STUN server and / or one TURN server.

  • Add BUNDLE support to use a single ICE/DTLS transport for multiple media.

  • Move media encoding / decoding off the main thread.

Data channels

  • Use SCTP ABORT instead of SHUTDOWN when stopping RTCSctpTransport.

  • Advertise support for SCTP RE-CONFIG extension.

  • Make RTCDataChannel emit open and close events.

Examples

  • Add an example of how to connect to appr.tc.

  • Capture audio frames to a WAV file in server example.

  • Show datachannel open / close events in server example.