Changelog

Mon, 01 Jan 0001 00:00:00 +0000

Changelog#

All notable changes to go-rtmp are documented here.

Unreleased#

Added#

SRT Encryption — Full AES-CTR encryption with passphrase-based key exchange (KMREQ/KMRSP), supporting AES-128/192/256 with PBKDF2 key derivation
SRT Key Rotation — Hitless even/odd key rekeying via post-handshake KMREQ control packets for long-running encrypted streams
SRT Reconnection Fix — Second SRT connection with same stream key no longer fails after first disconnects

Security#

Passphrase validation (10-79 characters per SRT specification)
Plaintext packets dropped on encrypted connections
Strict crypto profile validation (rejects unsupported cipher types)

v0.2.0 (2026-04-12)#

Added#

SRT (Secure Reliable Transport) Ingest: Accept SRT streams over UDP alongside RTMP
- SRT v5 handshake with SYN cookie exchange and extension negotiation
- Stream ID parsing: simple, prefixed, and structured formats
- TSBPD jitter buffer with configurable latency
- ACK/NAK reliability with RTT measurement and retransmission
- Optional AES encryption (128/192/256-bit) with PBKDF2 key derivation
MPEG-TS Demuxer: Full transport stream parser with PAT/PMT table decoding, PES reassembly
Codec Converters: H.264/H.265 Annex B→AVCC and AAC ADTS→raw converters for SRT-to-RTMP bridge
SRT-to-RTMP Bridge: End-to-end pipeline converting SRT data packets through TS demuxing and codec conversion
Codec-Aware Recording: Automatic container selection — FLV for H.264, MP4 for H.265/HEVC
FLV onMetaData Script Tag: FLV recordings include onMetaData with video dimensions, codec IDs, audio properties, and patched duration/filesize on close
- MP4 recorder streams to disk in real-time (zero memory buffering)
- Lazy recorder initialization for correct codec detection
Ingress Abstraction: Protocol-agnostic publish lifecycle manager shared by RTMP and SRT
Comprehensive E2E Test Suite: 25+ tests in e2e-tests/ covering all major features
SRT CLI Flags: -srt-listen, -srt-latency, -srt-passphrase, -srt-pbkeylen
SRT Metrics: 6 new expvar counters for SRT connections, bytes, packets, retransmits, drops
Comprehensive package documentation and developer guide

Changed#

MP4 recorder streams to disk instead of buffering in memory
Allocation optimizations across media handling hot paths
Lazy recorder initialization for codec-aware container selection

Fixed#

H.265 HEVCDecoderConfigurationRecord corrected per ISO/IEC 14496-15
-record-all explicit bool flag parsing
slog.SetDefault() now called for consistent log levels across subsystems
Three broken E2E tests (hooks and reconnect)

New Packages#

internal/srt/ — Full SRT protocol implementation (packet, circular, crypto, handshake, conn)
internal/ts/ — MPEG-TS demuxer
internal/codec/ — Video/audio codec converters (H.264, H.265, AAC)
internal/ingress/ — Publish lifecycle abstraction

v0.1.4 (2026-04-10)#

Added#

Enhanced RTMP (E-RTMP v2): H.265/HEVC, AV1, VP9 codec support via FourCC signaling
- Compatible with FFmpeg 6.1+, OBS 29.1+, SRS 6.0+
- Automatic codec detection — no configuration needed
- connect command negotiation with fourCcList echo
- Sequence header caching for all enhanced codecs (late-join support)
Enhanced audio signaling: Opus, FLAC, AC-3, E-AC-3 via E-RTMP FourCC
27 new unit tests for enhanced video/audio parsing
E2E test scripts: scripts/test-enhanced-rtmp.sh and .ps1

Changed#

Extracted shared fourCC() helper to media/codec.go
Simplified video diagnostic logging in registry
Fixed doc comment in connect_response.go

v0.1.3 (2026-04-09)#

Added#

RTMPS (TLS) support — encrypted RTMP connections via TLS termination at the transport layer
- New CLI flags: -tls-listen, -tls-cert, -tls-key
- Dual-listener architecture: plain RTMP and RTMPS simultaneously
- rtmps:// URL support in the Go client and relay destinations
- Minimum TLS 1.2 enforced; TLS startup failure is fatal (no silent fallback)
- 4 TLS integration tests with self-signed certificate helper
Cross-platform E2E testing scripts — comprehensive test suite in scripts/
- 12 scripts (6 Bash + 6 PowerShell pairs) for Linux/macOS/Windows
- 7 E2E test cases: RTMP, RTMPS, HLS hooks, authentication (allowed + rejected), combined TLS + auth
- Helper scripts: dependency checker, TLS cert generator, parameterized server launcher, HLS hook
Cross-platform build scripts — scripts/build.sh and scripts/build.ps1 for local compilation
Hugo documentation site — full docs with GitHub Pages deployment, Hugo-book theme

Fixed#

Shell hook Windows compatibility (powershell.exe detection instead of hardcoded /bin/bash)
Docs workflow Hugo version bump for theme compatibility
GitHub Pages deployment configuration

v0.1.2 (2026-03-04)#

Added#

Expvar metrics — live counters exposed via HTTP /debug/vars endpoint (-metrics-addr flag)
Disconnect handlers — proper cleanup of publisher/subscriber registrations on connection close
TCP deadline enforcement — read 90s / write 30s deadlines for zombie detection, reset on each I/O operation
Lifecycle hook events — new events: connection_close, publish_stop, play_stop, subscriber_count

Improved#

Performance optimizations:
- AMF0 decode: reduced allocations in object/array parsing
- Chunk writer: buffer reuse to avoid repeated allocation
- RPC: lazy initialization of command dispatcher
Dead code removal: removed unused bufpool package, ErrForbidden sentinel, and unused Session type

v0.1.1 (2026-03-03)#

Added#

Token-based authentication with 4 backends:
- token — static stream key/token pairs via CLI flags
- file — JSON file with stream key/token mappings
- callback — webhook URL for external auth validation
- none — open access (default)
URL query parameter parsing — tokens extracted from ?token=value in stream URLs
EventAuthFailed hook event — fires when authentication fails

v0.1.0 (2025-10-18)#

Added#

First feature-complete release of go-rtmp.

Roadmap

Mon, 01 Jan 0001 00:00:00 +0000

Roadmap#

Completed#

✅ Core RTMP protocol — handshake, chunks, AMF0, commands, media relay (v0.1.0)
✅ FLV recording — automatic recording with timestamped filenames (v0.1.0)
✅ Multi-destination relay — forward to YouTube, Twitch, and custom servers (v0.1.0)
✅ Event hooks — webhooks, shell scripts, stdio (v0.1.0)
✅ Authentication — token, file, callback, and open backends (v0.1.1)
✅ Expvar metrics — live counters via HTTP endpoint (v0.1.2)
✅ TCP deadline enforcement — zombie detection and cleanup (v0.1.2)
✅ Performance optimizations — AMF0 decode, chunk writer, RPC lazy-init (v0.1.2)
✅ RTMPS (TLS) — encrypted RTMP connections via TLS termination (v0.1.3)
✅ E2E testing scripts — cross-platform Bash + PowerShell test suite for RTMP/RTMPS/HLS/auth (v0.1.3)
✅ Enhanced RTMP (E-RTMP v2) — H.265, AV1, VP9 codec support via FourCC signaling (v0.1.4)
✅ SRT ingest — accept SRT streams over UDP with transparent RTMP conversion (v0.2.0)
✅ MPEG-TS demuxer — full transport stream parser for SRT-to-RTMP bridge (v0.2.0)
✅ Codec converters — H.264/H.265/AAC format converters for protocol bridging (v0.2.0)
✅ Codec-aware recording — automatic FLV/MP4 container selection based on codec (v0.2.0)
✅ Comprehensive E2E test suite — 25+ tests covering all features with cross-platform runners (v0.2.0)
✅ SRT Encryption — AES-CTR encryption with passphrase, key rotation (v0.4.0)

In Progress#

🔄 Fuzz testing — fuzz testing for AMF0 and chunk parsing to find edge cases and crashes

Planned#

📋 Configurable backpressure — tunable queue sizes, drop policies, and subscriber eviction strategies
📋 Clustering & HA — multi-node stream distribution with failover
📋 DVR / Time-shift — seek-back into recorded streams for live rewind
📋 Transcoding — on-the-fly quality adaptation (ABR) for multi-bitrate delivery (note: H.265/HEVC is now natively supported for passthrough via E-RTMP v2 and SRT ingest)

How to Contribute#

If you’re interested in working on any planned feature, open an issue to discuss the approach before starting. See the Contributing Guide for workflow details.

Project on go-rtmp

Changelog

Changelog#

Unreleased#

Added#

Security#

v0.2.0 (2026-04-12)#

Added#

Changed#

Fixed#

New Packages#

v0.1.4 (2026-04-10)#

Added#

Changed#

v0.1.3 (2026-04-09)#

Added#

Fixed#

v0.1.2 (2026-03-04)#

Added#

Improved#

v0.1.1 (2026-03-03)#

Added#

v0.1.0 (2025-10-18)#

Added#

Roadmap

Roadmap#

Completed#

In Progress#

Planned#

How to Contribute#