v1.0.0

Why 1.0?

This software now supports all the main streaming protocols (SRT / WebRTC / RTSP / RTMP / LL-HLS), a wide range of codecs, a series of innovative protocol-codec combinations (for instance HLS + AV1), and is deployed in production environments. The main objective of the project has been achieved, that is to provide a routing solution for real-time media streams to any user, from householders that want to manage their video feeds to developers that need to route media streams to and from microservices.

There are a couple of secondary features that will be certainly developed in the near future (native recording, native scalability, both can already be achieved by using external integrations) but other than that the focus will be on fixing eventual issues related to the existing features.

New features

SRT

• support publishing, reading, proxying with SRT (#2068)

WebRTC

• support proxying WebRTC streams with WHEP (#2142)

HLS

• support muxing and proxying AV1 tracks (#2155)
• support muxing and proxying VP9 tracks (#2162)

UDP

• support reading MPEG-1 tracks (#2147)

General

• support setting a maximum number of readers per path (#1286) (#2154)

Fixes and improvements

RTSP

• support G726 format (bluenviron/gortsplib#330)
• fix race condition in WritePacketRTP() (bluenviron/gortsplib#334)
• fix SDP unmarshaling with Vurix NVR (#2128)
• add VP8/VP9 limits

HLS

• show IP in logs in case of failed authentication (#2099)
• prevent brute-force attacks by waiting before sending responses (#2100)
• reply status code 204 to OPTIONS requests (#2141)
• prefer Opus tracks to MPEG-4 tracks (#2158)
• fix parsing decimal EXT-X-TARGETDURATION (bluenviron/gohlslib#55)
• fix parsing EXT-X-STREAM-INF with spaces (bluenviron/gohlslib#56)
• fix parsing playlists without trailing newline (bluenviron/gohlslib#58)
• add Cache-Control header to all responses
• prepend prefix to segments. . This is needed to prevent usage of cached segments from previous muxing sessions

WebRTC

• show both IP and port during session creation and in API (#2096)
• send session ID to external auth server (#1981) (#2098)
• show IP in logs in case of failed authentication (#2099)
• prevent brute-force attacks by waiting before sending responses (#2100)
• speed up track detection (#2105)
• fix race condition when broadcasting RTP packets (#2117)
• reply status code 204 to OPTIONS requests (#2141)

UDP

• support using domain names instead of IPs (#2150)

API

• fix crash when calling /v1/webrtcsessions/list just after session creation (#2097)
• add transport to RTSP sessions (#2151)
• remove sourceReady from docs (#2163)

General

• return an error in case the random number generator fails (#2120)
• remove warning when decoding VP8 or VP9 (#2159). . avoid printing 'received a non-starting fragment without any previous starting fragment'
• disable check for missing key frames (#1904) (#2161)
• rename disablePublisherOverride into overridePublisher (#2164)
• remove 'disable' from names of configuration parameters (#2101)
• fix crash in case of specially-crafted HTTP requests (#2166) (#2169)
• Add video player options via query string (#2145)
• mpegts: fix panic with specially-crafted strings; add fuzzing (bluenviron/mediacommon#29)
• h264, h265: raise MaxNALUSize (bluenviron/mediacommon#30)
• h264, h265: rename MaxNALUSize to MaxAccessUnitSize and apply to entire access unit (bluenviron/mediacommon#36)
• h264: fix 'invalid POC' error (bluenviron/mediacommon#55)

Dependencies

• build(deps): bump github.com/pion/rtp from 1.7.13 to 1.8.0 (#2091)
• build(deps): bump github.com/pion/webrtc/v3 from 3.2.12 to 3.2.13 (#2092)
• build(deps): bump github.com/gookit/color from 1.5.3 to 1.5.4 (#2089)
• build(deps): bump github.com/abema/go-mp4 from 0.10.1 to 0.11.0 (#2112)
• build(deps): bump github.com/pion/rtp from 1.8.0 to 1.8.1 (#2129)
• build(deps): bump golang.org/x/net from 0.12.0 to 0.13.0 (#2139)
• build(deps): bump github.com/pion/webrtc/v3 from 3.2.13 to 3.2.14 (#2140)
• build(deps): bump golang.org/x/term from 0.10.0 to 0.11.0 (#2148)
• build(deps): bump golang.org/x/net from 0.13.0 to 0.14.0 (#2170)
• build(deps): bump github.com/pion/ice/v2 from 2.3.9 to 2.3.10 (#2171)
• build(deps): bump github.com/asticode/go-astits

v0.23.8

Fixes and improvements

General

• hls, webrtc: add Authorization to Access-Control-Allow-Headers (#2018) (#2020)
• stop execution in case of panics when handling HTTP requests (#2021)
• disable colored log lines when output is not a terminal (#1477) (#2050)
• make sure components are closed in a specific order (#2065)
• update list of supported codecs inside error messages (#2058) (#2073)

WebRTC

• allow removing default WebRTC ICE server with environment variables (#2064)
• fix race condition that caused random crashes during handshake (#2072)
• fix memory leak during shutdown or session kick (#2079)
• display publish-related errors in web page (#1836) (#2080)

Raspberry Pi Camera

• fix a compile error with recent libcamera (#2081) by @hideaki-t
• rpi camera: add rpiCameraHDR parameter (#1876) (#2083)

API

• add path to RTMP connections, RTSP sessions, WebRTC sessions (#1962) (#2022)
• apidocs: fix source/reader types (#2027)
• fix error in case of nested paths (#2040) by @Jordy84
• return 404 when a path configuration is not found (#2067) (#2074)
• allow to edit properties of path config "all" (#2067) (#2075)
• add 'readyTime' to paths (#2049) (#2082)

Dependencies

• build(deps): bump golang.org/x/net from 0.11.0 to 0.12.0 (#2025)
• build(deps): bump github.com/pion/ice/v2 from 2.3.8 to 2.3.9 (#2031)
• build(deps): bump github.com/pion/webrtc/v3 from 3.2.11 to 3.2.12 (#2051)

v0.23.7

Fixes and improvements

General

• set Access-Control-Allow-Headers to a static string (#1973)

WebRTC

• do not pass preflight requests to external auth (#1941) (#1972)
• in the web page, pass query parameters to inner requests (#1976)
• fix memory leak when publishing or reading (#1884) (#1983)
• fix bitrate not being applied (#1984)
• forbid publishing zero tracks (#1991)
• allow setting Opus bitrate (#1908) (#1985)
• add option to disable audio effects (#1908) (#1989)
• move codec and bitrate settings on client side (#1990)
• support publishing with OBS and WebRTC (#1998)
• allow using special characters in ICE server credentials (#1953) (#2000)

RTSP

• generate RTCP receiver reports even before receiving RTCP sender reports (bluenviron/gortsplib#318). . (#1739)

HLS

• in the web page, pass query parameters to inner requests (#1976)

RPI Camera

• check libcamera architecture by using the ELF header (#1940) (#1997)

API

• return 404 in /get and /kick endpoints (#1994) (#1995). . when an entity is not found

Dependencies

• bump github.com/pion/webrtc/v3 from 3.2.10 to 3.2.11 (#2002)

v0.23.6

Fixes and improvements

General

• fix 'runOnDemandRestart: yes' (#1947)
• rename environment variable RTSP_PATH into MTX_PATH (#1967)
• add Arch Linux package to the README (#1957) (#1969)

WebRTC

• make preflight OPTIONS requests work with external auth (#1941) (#1964)
• fix using inline credentials in URLs (#1919) (#1966)

RTSP

• return an error in case of invalid packet (bluenviron/gortsplib#305). . when reading with TCP and packet has an unknown format.
• allow using odd interleaved IDs (bluenviron/gortsplib#304) (#1762)
• client: support URLs with IPv6 and no port (bluenviron/gortsplib#313) (bluenviron/gortsplib#316)

HLS

• support ISO8601 dates (bluenviron/gohlslib#50) (#1958)

Dependencies

• build(deps): bump github.com/pion/webrtc/v3 from 3.2.9 to 3.2.10 (#1932)
• build(deps): bump golang.org/x/crypto from 0.9.0 to 0.10.0 (#1945)
• build(deps): bump golang.org/x/net from 0.10.0 to 0.11.0 (#1946)
• build(deps): bump github.com/pion/ice/v2 from 2.3.7 to 2.3.8 (#1956)

v0.23.5

Fixes and improvements

• Add Docker images with FFmpeg included and change docker repository name (#1771) (#1909) (#1923). Available images now are:

  name	FFmpeg included	RPI Camera support
  bluenviron/mediamtx:latest	❌	❌
  bluenviron/mediamtx:latest-ffmpeg	✔️	❌
  bluenviron/mediamtx:latest-rpi	❌	✔️
  bluenviron/mediamtx:latest-ffmpeg-rpi	✔️	✔️

• return an error in case default configuration file can't be opened (#1920)

• bump github.com/pion/webrtc/v3 from 3.2.8 to 3.2.9 (#1906)

v0.23.4

Fixes and improvements

General

• allow using special characters in external commands (#1652) (#1868), on Windows, when using cmd.exe or a bat file as external command.
• print error that caused an external command to exit (#1869)
• fix sending session ID to external authentication (#1871). this fixes a regression introduced in v0.23.0
• replace math/rand with crypto/rand, increasing security (#1872)

WebRTC

• Add WebRTC stream id to whep response headers (#1879) by @vvitkovsky

RTSP

• support otherDataPresent and crcCheckPresent inside StreamMuxConfig of MP4A-LATM format (bluenviron/mediacommon#18) (#1881)
• fix using multicast when a single interface doesn't support it (bluenviron/gortsplib#293) (https://github.com/bluenviron/mediamtx/discussions/1744)

RTMP

• fix timestamp conversion from RTSP/HLS to RTMP (#1899). this was causing moments of silence and timing errors when reading with RTMP a stream originally published with RTSP or HLS.
• support reading MP4A-LATM-encoded AAC with RTMP and HLS (#1694) (#1898)

HLS

• support reading MP4A-LATM-encoded AAC with RTMP and HLS (#1694) (#1898)

UDP

• fix using multicast when a single interface doesn't support it (#1874)

RPI Camera

• allow using decimal FPS (#1743) (#1873)

API

• fix setting default parameters when creating a path (#1853) (#1905). . this fixes a regression introduced in v0.23.0.

Dependencies

• build(deps): bump github.com/pion/webrtc/v3 from 3.2.6 to 3.2.8 (#1862)
• build(deps): bump github.com/stretchr/testify from 1.8.3 to 1.8.4 (#1880)
• build(deps): bump github.com/gin-gonic/gin from 1.9.0 to 1.9.1 (#1897)

v0.23.3

Fixes and improvements

WebRTC

• fix WHIP/WHEP implementation (#1857) (#1861). Offers and answers are now encoded in SDP in place of JSON; Location header is sent to clients. This fixes compatibility with GStreamer and whipsink.

HLS

• fix parsing multivariant playlists with windows-style newlines (bluenviron/gohlslib#43)

Dependencies

• bump github.com/pion/ice/v2 from 2.3.4 to 2.3.5 (#1854)
• bump github.com/bluenviron/gohlslib from 0.2.4 to 0.2.5 (#1855)
• bump github.com/pion/webrtc/v3 from 3.2.4 to 3.2.6 (#1856)

v0.23.2

RTSP

• fix sending keepalives to sources (#1812) (bluenviron/gortsplib#287). This fixes a regression introduced in v0.23.0

WebRTC

• Expose E-Tag, Accept-Patch and Link headers for cross-origin WHIP/WHEP requests (#1841)
• add POST and PATCH methods to Access-Control-Allow-Methods (#1848)

API

• allow using paths/list endpoint when a path is being deleted (#1849)

v0.23.1

Note

This release is mostly dedicated to fix regressions introduced in v0.23.0. Major releases allow to introduce new features, but every addition is linked the risk of breaking something. Thanks to all the people that immediately tested the new version, reported issues and allowed to quickly develop the fixes included in this release: @tbnguyen1407, @alpe12, @felder, @nigelsim, @blu006, @Tokolosh, @0ip

Fixes and improvements

WebRTC

• fix exception in browser when webrtcICEServers is empty (#1817) (#1821). this fixes a regression introduced in v0.23.0.

RTMP

• fix crash when publishing video-only tracks (#1819) (#1822). this fixes a regression introduced in v0.23.0.

HLS

• fix 404 error when hlsAlwaysRemux and sourceOnDemand are both true (#1818) (#1834)

API

• bump API prefix from /v1 to /v2 (#1815)
• add /get endpoints (#1577) (#1823). this allows to get entities by ID or name after /list endpoints were changed in v0.23.0.
• fix wrong pageCount in /list endpoints (#1813) (#1824)
• add item count to /list endpoints (#1813) (#1829)
• sort results of /list endpoints (#1828)

General

• fix missing H264/H265 keyframe warning message (#1825)

v0.23.0

New features

General

• add darwin/arm64 binary (#1789) by @a-wing

RTMP

• support publishing H265 and AV1 tracks with Enhanced RTMP (#1393) (#1446) (#1621) (#1756) . This restores compatibility with OBS 29.1.
• support publishing, reading and proxying MPEG-2 audio (MP3) tracks (#1102) (#1736)

WebRTC

• support publishing streams with WebRTC and the WHIP specification (#1659) (#1786). You can publish streams by either opening http://localhost:8889/mystream/publish` inside the browser or using the WHIP URL http://localhost:8889/mystream/whip.
• support reading streams with WebRTC and the WHEP specification (#1800). You can read streams by either opening http://localhost:8889/mystream inside the browser or using the WHEP URL http://localhost:8889/mystream/whep.
• support reading AV1 tracks with WebRTC (#1768)

API

• add pagination to all /list endpoints (#1808) (BREAKING CHANGE)

Fixes and improvements

General

• change repository owner (#1801)
• print warning in case no key frames are being received (#1763)
• return error in case of string-to-int overflows (#1776)
• allow external authentication to return an error by using the HTTP body (#1756)
• mpeg4audio: fix crash when unmarshaling specially-crafted ADTS packets (bluenviron/mediacommon#4)
• mpeg4audio: fix number of channels of PS object types (https://github.com/bluenviron/5)
• build(deps): bump github.com/pion/webrtc/v3 from 3.1.59 to 3.1.62 (#1721)
• build(deps): bump golang.org/x/crypto from 0.8.0 to 0.9.0 (#1783)

WebRTC

• validate ICE servers in configuration (#1798)
• remove pion/ice replacement (#1803)
• discard empty RTP packets coming from Chrome (#1804)
• return 404 when a stream is not present (#1805)

RTSP

• Allow sending Range header to RTSP sources (#1780) by @Jordy84
• handle additional fields of MPEG4-generic: streamtype, mode, profile-level-id (bluenviron/gortsplib#250)
• fix parsing of MP4A-LATM formats with no channels and object (bluenviron/gortsplib#254) (#1716)
• infer object, sample rate, clock of MPEG4AudioLATM from config (bluenviron/gortsplib#255)
• support fragmented MPEG-2 audio frames (bluenviron/gortsplib#259)
• rtpmpeg2audio: improve decoder robustness (bluenviron/gortsplib#262)
• fix timeout with some cameras by decreasing interval between keepalives (bluenviron/gortsplib#265) (#1403)
• print number of lost packets even when using TCP (bluenviron/gortsplib#269)
• add 32-bit tests; return errors in case of string-to-int overflows (bluenviron/gortsplib#276)
• fix compatibility with Mercury cameras (bluenviron/gortsplib#271) (bluenviron/gortsplib#275)
• rtptime: fix time encoding on arm32 (bluenviron/gortsplib#274) (bluenviron/gortsplib#277)
• server: remove dashes from session ID (bluenviron/gortsplib#278)

HLS

• bump hls.js (#1807)
• show index page even if stream is not present (#1806)
• muxer: print error in case generation of init.mp4 fails (bluenviron/gohlslib#30)
• add 32-bit tests; return errors in case of string-to-int overflows (bluenviron/gohlslib#39)
• force some integers to be unsigned (bluenviron/gohlslib#40)

Raspberry Pi Camera

• allow setting rpiCameraSaturation to 0 (#1651) (#1772)

Metrics

• fix: metrics listener address sanitization (#1774) by @tnyeanderson

API

• fix type of RTMPS readers (#1784) . it was wrongly set to RTMP.