datarhei-dragonfork-core/CHANGELOG.md

Datarhei — Dragon Fork

v0.1.0-dragonfork (2026-05-03)

The first tagged Dragon Fork release. Forked from upstream datarhei Core v16.16.0; everything upstream does is preserved unchanged. New: WebRTC (WHEP) egress, integrated with the existing process supervisor.

Added

• WebRTC subsystem under app/webrtc/, mirroring the shape of upstream's RTMP and SRT servers (Server interface, Echo handlers, process-graph hooks, admin endpoints).
• Per-process opt-in via config.webrtc.enabled on every restream process; resolver auto-injects two RTP output legs and allocates loopback UDP ports.
• POST /api/v3/whep/{id} — WebRTC-HTTP Egress Protocol subscribe. JWT-protected by the existing Core auth.
• DELETE /api/v3/whep/{id}/{resource} — idempotent teardown (returns 204 even on unknown resource per WHEP spec).
• PATCH /api/v3/whep/{id}/{resource} — trickle ICE.
• CORS preflight on every WHEP route + Access-Control-Expose-Headers for Location and ETag so browser-side WHEP players work cross-origin.
• Configurable stream maps via webrtc.video_map / webrtc.audio_map on the per-process config — defaults to 0:v:0 / 0:a:0 for RTMP/SRT publishers, overridable for multi-input pipelines.
• webrtc.* global config block with CORE_WEBRTC_* env-var bindings parallel to RTMP and SRT.
• Admin API: GET /api/v3/webrtc/streams + /streams/{id}/peers.
• Browser smoke player at test/whep-player.html with ICE / codec / bitrate diagnostics, JWT field, and ?url=&token= shareable URLs.
• Server-hop latency p95 gate in CI (-tags latency), enforced at 50ms on the runner; locally observed p95 ≈ 240µs.
• TrueNAS deploy bundle at deploy/truenas/core/ — host-networked Docker stack with bundled FFmpeg, env-driven config.
• Multi-viewer correctness: per-stream peer cap, ICE-failure auto-cleanup goroutines, process-stop broadcast tear-down.
• Error matrix: 406 codec mismatch, 504 ICE timeout, 503 cap reached (separate body for total vs per-stream), 204 DELETE idempotent.

Fixed

• Config.Clone() now preserves the WebRTC section. Pre-fix, cfg.WebRTC.Enable was always zero at runtime regardless of CORE_WEBRTC_ENABLE. Caught on the first M2 TrueNAS deploy.
• http/api.ProcessConfig Marshal/Unmarshal now carry the per-process webrtc block. Pre-fix, POST /api/v3/process silently dropped webrtc.enabled=true on its way to the restream config layer.

Forking notes

• Module path stays github.com/datarhei/core/v16 — internal imports don't churn, the fork is distinguished by repo location and branch history.
• cmd/webrtc-poc from M1 is preserved as a manual-testing harness. Production deploys use the main core binary.

Acknowledgements

Built on upstream Datarhei Core (Apache 2.0) and Pion WebRTC v4 (MIT). Full attribution in NOTICE and CREDITS.

---

Core (upstream)

Core v16.15.0 > v16.16.0

• Add ConnectionIdleTimeout to RTMP server
• Add WithLevel() to Logger interface
• Fix datarhei/restreamer#759
• Fix various RTMP bugs
• Fix wrong log output when receiving a RTMP stream
• Fix skipping session handling if collectors are nil
• Update dependencies

Core v16.14.0 > v16.15.0

• Add migrating to ffmpeg 6
• Fix missing process data if process has been deleted meanwhile
• Fix maintaining the metadata on process config update (datarhei/restreamer#698)
• Fix placeholder parsing
• Fix concurrent memfs accesses
• Fix memfs concurrent read and write performance

Core v16.13.1 > v16.14.0

• Add support for SRTv4 clients
• Add support for Enhanced RTMP in internal RTMP server
• Fix require positive persist interval (session)
• Fix race condition (process)
• Update dependencies

Core v16.13.0 > v16.13.1

• Fix transfer of reports to updated process
• Fix calling Wait after process has been read
• Fix 509 return code if non-existing stream is requested
• Fix default search paths for config file
• Fix sized filesystem
• Update dependencies

Core v16.12.0 > v16.13.0

• Add updated_at field in process infos
• Add preserve process log history when updating a process
• Add support for input framerate data from jsonstats patch
• Add number of keyframes and extradata size to process progress data
• Mod bumps FFmpeg to v5.1.3 (datarhei/core:tag bundles)
• Fix better naming for storage endpoint documentation
• Fix freeing up S3 mounts
• Fix URL validation if the path contains FFmpeg specific placeholders
• Fix purging default file from HTTP cache
• Fix parsing S3 storage definition from environment variable
• Fix checking length of CPU time array (#10)
• Fix possible infinite loop with HLS session rewriter
• Fix not propagating process limits
• Fix URL validation if the path contains FFmpeg specific placeholders
• Fix RTMP DoS attack (thx Johannes Frank)
• Deprecate ENV names that do not correspond to JSON name

Core v16.11.0 > v16.12.0

• Add S3 storage support
• Add support for variables in placeholde parameter
• Add support for RTMP token as stream key as last element in path
• Add support for soft memory limit with debug.memory_limit_mbytes in config
• Add support for partial process config updates
• Add support for alternative syntax for auth0 tenants as environment variable
• Fix config timestamps created_at and loaded_at
• Fix /config/reload return type
• Fix modifying DTS in RTMP packets (restreamer/#487, restreamer/#367)
• Fix default internal SRT latency to 20ms

Core v16.10.1 > v16.11.0

• Add FFmpeg 4.4 to FFmpeg 5.1 migration tool
• Add alternative SRT streamid
• Mod bump FFmpeg to v5.1.2 (datarhei/core:tag bundles)
• Fix crash with custom SSL certificates (restreamer/#425)
• Fix proper version handling for config
• Fix widged session data
• Fix resetting process stats when process stopped
• Fix stale FFmpeg process detection for streams with only audio
• Fix wrong return status code (#6))
• Fix use SRT defaults for key material exchange

Core v16.10.0 > v16.10.1

• Add email address in TLS config for Let's Encrypt
• Fix use of Let's Encrypt production CA

Core v16.9.1 > v16.10.0

• Add HLS session middleware to diskfs
• Add /v3/metrics (get) endpoint to list all known metrics
• Add logging HTTP request and response body sizes
• Add process id and reference glob pattern matching
• Add cache block list for extensions not to cache
• Mod exclude .m3u8 and .mpd files from disk cache by default
• Mod replaces x/crypto/acme/autocert with caddyserver/certmagic
• Mod exposes ports (Docker desktop)
• Fix assigning cleanup rules for diskfs
• Fix wrong path for swagger definition
• Fix process cleanup on delete, remove empty directories from disk
• Fix SRT blocking port on restart (upgrade datarhei/gosrt)
• Fix RTMP communication (Blackmagic Web Presenter, thx 235 MEDIA)
• Fix RTMP communication (Blackmagic ATEM Mini, #385)
• Fix injecting commit, branch, and build info
• Fix API metadata endpoints responses

Core v16.9.0 > v16.9.1^

• Fix v1 import app
• Fix race condition

Core v16.8.0 > v16.9.0

• Add new placeholders and parameters for placeholder
• Allow RTMP server if RTMPS server is enabled. In case you already had RTMPS enabled it will listen on the same port as before. An RTMP server will be started additionally listening on a lower port number. The RTMP app is required to start with a slash.
• Add optional escape character to process placeholder
• Fix output address validation for tee outputs
• Fix updating process config
• Add experimental SRT connection stats and logs API
• Hide /config/reload endpoint in reade-only mode
• Add experimental SRT server (datarhei/gosrt)
• Create v16 in go.mod
• Fix data races, tests, lint, and update dependencies
• Add trailing slash for routed directories (datarhei/restreamer#340)
• Allow relative URLs in content in static routes

Core v16.7.2 > v16.8.0

• Add purge_on_delete function
• Mod updated dependencies
• Mod updated API docs
• Fix disabled session logging
• Fix FFmpeg skills reload
• Fix ignores processes with invalid references (thx Patron Ramakrishna Chillara)
• Fix code scanning alerts