09 Jan 16:41

JoTurk

4a5fbf4

v4.2.2 Latest

Latest

What's Changed

Special thanks to @AkshayJainG for reporting and diagnosing several panic conditions in the IVF and OGG readers caused by malformed inputs. these fixes improve robustness when handling untrusted or malformed media inputs using ogg reader or ivf reader.

Update module github.com/pion/rtp to v1.9.0 by @renovate[bot] in #3324
Simplify interface to handleUnknownRTPPacket by @jech in #3329
Fix data race in RTX by @JoTurk in #3332
Add WithRTPSequenceNumber by @JoTurk in #3337
Implement support for remote offers that are not actpass by @fippo in #3325
Update module github.com/pion/stun/v3 to v3.1.0 by @renovate[bot] in #3338
Fix typo in custom-logger example by @boushley in #3340
Rename dtlsRoleFromRemoteSDP to dtlsRoleFromSDP by @fippo in #3341
Update pion-to-pion example to clarify differences. by @boushley in #3342
Fix panics in OGG API by @AkshayJainG @JoTurk in #3346
Update module github.com/pion/dtls/v3 to v3.0.10 by @renovate[bot] in #3348
Update module github.com/pion/stun/v3 to v3.1.1 by @renovate[bot] in #3349
Upgrade to pion/transport v4 by @JoTurk in #3344
Fix divide by zero in IVF reader by @AkshayJainG @JoTurk in #3353
Add new repacketize example by @Juliapixel in #3350
SetConfiguration now updates ICEGatherer's servers by @wrangelvid in #3339
Ensure candidate gathering promise completes by @boushley in #3347
Update module github.com/pion/interceptor to v0.1.43 by @renovate[bot] in #3354

New Contributors

@fippo made their first contribution in #3325
@Juliapixel made their first contribution in #3350
@wrangelvid made their first contribution in #3339

Full Changelog: v4.2.1...v4.2.2

Contributors

boushley, fippo, and 6 other contributors

Assets 2

24 Dec 11:36

github-actions

v4.2.1

a5ce252

v4.2.1

Changelog

a5ce252 Assert no repair after stop
48f7ac7 Check for closed receiver before setting up rid

Assets 2

23 Dec 21:44

JoTurk

v4.2.0

45fa3ed

v4.2.0

We are pleased to announce our final and largest release of 2025. This release includes contributions from 69 contributors.

This release also marks a new era for Pion. Going forward, we will publish releases on a regular schedule.

Major new features

RACK

We are happy to announce that SCTP now includes a RACK implementation, enabled by default. This work is included in pion/sctp#390 and pion/sctp#438, with a reported 71% improvement in maximum throughput and 27% better latency.

ICE Renomination

Pion now supports ICE renomination It was added in pion/ice#822 and pion/ice#799, and integrated into WebRTC in #3306. It can be enabled via the SettingEngine.

// For advanced use with a custom generator and interval.
se := webrtc.SettingEngine{}

interval := 2 * time.Second
customGen := func() uint32 { return uint32(time.Now().UnixNano()) } // example

if err := se.SetICERenomination(
	webrtc.WithRenominationGenerator(customGen),
	webrtc.WithRenominationInterval(interval),
); err != nil {
	log.Println(err)
}

Cryptex

Pion now supports Cryptex, enabling full encryption of RTP headers and header extensions. This work is included in pion/srtp#324 and pion/sdp#213.

FlexFEC

FlexFEC has been added, is stable, and is ready for production use. See pion/interceptor#333, #3075, pion/interceptor#330, pion/interceptor#344, and pion/interceptor#383.

ICEAddressRewriteRule

Pion’s NAT 1:1 API is now deprecated. After years of use, it no longer fits modern deployment models. This change is implemented in pion/ice#834 and #3309.

The new API, SetICEAddressRewriteRules(rules ...ICEAddressRewriteRule) error, rewrites the IP addresses embedded in gathered ICE candidates.

Rule fields (high level):

External []string: the address or addresses you want to expose
Matchers: Local, CIDR, or Iface
Mode: Replace (default) or Append (keep the original and add the rewritten candidate)
Optional: AsCandidateType (for example, rewrite as srflx)

se := webrtc.SettingEngine{}

_ = se.SetICEAddressRewriteRules(
	webrtc.ICEAddressRewriteRule{
		Local:    "10.0.0.12",
		External: []string{"203.0.113.10"},
		// Mode omitted, defaults to Replace.
	},
)

api := webrtc.NewAPI(webrtc.WithSettingEngine(se))
// pc, _ := api.NewPeerConnection(...)

// For more advanced use.
se := webrtc.SettingEngine{}

se.SetICEAddressRewriteRules(
	// Allow eth0 (map RFC1918 to public 203.0.113.10)
	webrtc.ICEAddressRewriteRule{
		Iface:    "eth0",
		CIDR:     "10.0.0.0/8",
		External: []string{"203.0.113.10"},
		Mode:     webrtc.ICEAddressRewriteReplace,
	},

	// Allow eth1 (map 192.168/16 to public 198.51.100.20)
	webrtc.ICEAddressRewriteRule{
		Iface:    "eth1",
		CIDR:     "192.168.0.0/16",
		External: []string{"198.51.100.20"},
		Mode:     webrtc.ICEAddressRewriteReplace,
	},

	// Catch-all: drop any other IPv4 host candidates
	webrtc.ICEAddressRewriteRule{
		CIDR:     "0.0.0.0/0",
		Mode:     webrtc.ICEAddressRewriteReplace,
		External: nil, // drop
	},

	// Catch-all: drop any other IPv6 host candidates
	webrtc.ICEAddressRewriteRule{
		CIDR:     "::/0",
		Mode:     webrtc.ICEAddressRewriteReplace,
		External: nil, // drop
	},
)

SVT-AV1

Adds a new AV1 video encoder to pion/mediadevices backed by SVT-AV1: pion/mediadevices#660.

HEVC reader and writer

#3171
- pkg/media/h265reader parses an H.265/HEVC Annex-B byte stream (start-code delimited) into NAL units you can work with.
- pkg/media/h265writer takes H.265 RTP payloads (RFC 7798) and writes them back out as an Annex-B bytestream, which is useful for recording and archiving.

New OGG Reader API

A series of improvements to oggreader:
- #3301 adds OpusTags support via ParseOpusTags, enabling access to artist, title, and vendor comments.
- #3299 expands ParseOpusHead to parse Opus channel mappings for multichannel layouts.
- #3300 updates oggreader to handle multi-track Ogg by routing pages by serial and introducing NewWithOptions along with richer page and header APIs.
- #3302 validates the full flow by streaming single-track and multi-track Ogg with a playlist and metadata over DataChannel control, while audio remains on the RTP track.

More great features

Do not discard SEI NALs for H264/H265 — #3313
Use ping-pong buffer for batch conn — pion/transport#363
Add CanTrickleICECandidates — #3283
Add nohost gather policy — #3305
Make Allocation/Permission lifetime configurable — pion/turn#495
RFC: Add a configurable sized nonce generator — pion/turn#460
Add AudioPlayoutStatsProvider interface for getting media-playout stats — #3234
Expose stats ID for use in interceptor factories — #3249
Allow IVFWriter Width/Height to be modified — #3219
Allow IVFWriter Framerate to be modified — #3220

New Examples

Add ice-proxy example (2) — #3165
Add Play from disk ogg playlist example — #3302
Add examples/encrypt-decrypt — pion/srtp#353
Add simple datachannel example with demo.html — #3252
Add real-time encoder integration example — pion/bwe-test#99
Add gocv-to-webrtc — pion/example-webrtc-applications#370
Create examples/data-channels-detach-create — #3225

Major bug fixes

Fix a deadlock in TaskLoop — pion/ice#840
Fix a deadlock with Abort — pion/sctp#441
Fix nack deadlocks from writers — pion/interceptor#387
Fix race condition in setSelectedPair — pion/ice#826
Fix memory leak with nackCountLogs — pion/interceptor#386
Fix a leak with pop in pending_queue — pion/sctp#401
Fix PacketsReceived underflow — pion/interceptor#389
Fix RTP timestamp drift in WriteSample — #3312
Prevent negative intervals — pion/dtls#760
Do not block on SCTP accept if the transport is aborted — #3308
Fix infinite loop when current time equals deadline — pion/transport#359
Fix zero-delta case in overuse detector — pion/interceptor#369
Fix off-by-one in TwoByteHeaderExtension.Set — pion/rtp#335
Fix off-by-one in OneByteHeaderExtension.Set — pion/rtp#334
Fix unmarshalling extension-only packet — pion/rtp#325
Fix padding overflow with PacketFactory — pion/interceptor#338
Fix RTPSender.SetReadDeadline crash — #3224
fix track.unbind panic — pion/mediadevices#634
Do not invoke OnBufferedAmountLow after close — #3291
Emit a disconnected state before failing — pion/ice#846
Fix error reporting in SendIndication handler — pion/turn#466
Fix sender/receiver reports in whip-whep example — #3167
Permissively parse SDPs unless completely invalid — #3297
Warn on non-zero reliability parameter for reliable channels — pion/datachannel#263
Assert DONT-FRAGMENT behavior in Server (1) — pion/turn#494
Assert DONT-FRAGMENT behavior in Server (2) — pion/turn#493
Add Unknown Attribute Handler — pion/turn#486