[](https://github.com/AlexxIT/go2rtc/stargazers) [](https://hub.docker.com/r/alexxit/go2rtc) [](https://github.com/AlexxIT/go2rtc/releases) [](https://goreportcard.com/report/github.com/AlexxIT/go2rtc)

Ultimate camera streaming application with support for RTSP, WebRTC, HomeKit, FFmpeg, RTMP, etc.

• zero-dependency and zero-config small app for all OS (Windows, macOS, Linux, ARM)
• zero-delay for many supported protocols (lowest possible streaming latency)
• streaming from RTSP, RTMP, DVRIP, HTTP (FLV/MJPEG/JPEG/TS), USB Cameras and other sources
• streaming from any sources, supported by FFmpeg
• streaming to RTSP, WebRTC, MSE/MP4, HomeKit HLS or MJPEG
• publish any source to popular streaming services (YouTube, Telegram, etc.)
• first project in the World with support streaming from HomeKit Cameras
• on-the-fly transcoding for unsupported codecs via FFmpeg
• play audio files and live streams on some cameras with speaker
• multi-source two-way codecs negotiation
• mixing tracks from different sources to single stream
• auto-match client-supported codecs
• two-way audio for some cameras
• can be integrated to any smart home platform or be used as standalone app

Supported Formats - describes the communication API: authorization, encryption, command set, structure of media packets

• devices: alsa (Linux audio), v4l2 (Linux video)
• files: adts, flv, h264, hevc, hls, mjpeg, mpegts, mp4, wav
• network (public and well known): mpjpeg, onvif, rtmp, rtp, rtsp, webrtc, yuv4mpegpipe
• network (private and exclusive): bubble, doorbird, dvrip, eseecloud, gopro, hass (Home Assistant), homekit (Apple), isapi (Hikvision), kasa (TP-Link), multitrans (TP-Link), nest (Google), ring, roborock, tapo and vigi (TP-Link), tuya, webtorrent, wyze, xiaomi (Mi Home)
• webrtc related: creality, kinesis (Amazon), openipc, switchbot, whep, whip, wyze
• other: ascii, echo, exec, expr, ffmpeg

Supported Protocols - describes the transport for data transmission

• public: http, pipe, rtmp, rtsp, tcp, udp, webrtc, ws (WebSocket)
• private: cs2 (PPPP), hap and hds (HomeKit), tutk (P2P)

Inspired by:

• series of streaming projects from @deepch
• webrtc go library and whole @pion team
• rtsp-simple-server idea from @aler9
• GStreamer framework pipeline idea
• MediaSoup framework routing idea
• HomeKit Accessory Protocol from @brutella
• creator of the project's logo @v_novoseltsev

[!CAUTION] The official website of the project is this GitHub repository and go2rtc.org (hosted on GitHub Pages). The website go2rtc[.]com is in no way associated with the authors of this project.

• Fast start
• go2rtc: Binary
• go2rtc: Docker
• go2rtc: Home Assistant Add-on
• go2rtc: Home Assistant Integration
• go2rtc: Dev version
• Configuration
• Module: Streams
• Two way audio
• Source: RTSP
• Source: RTMP
• Source: HTTP
• Source: ONVIF
• Source: FFmpeg
• Source: FFmpeg Device
• Source: Exec
• Source: Echo
• Source: Expr
• Source: HomeKit
• Source: Bubble
• Source: DVRIP
• Source: Tapo
• Source: Kasa
• Source: Multitrans
• Source: Tuya
• Source: Xiaomi
• Source: Wyze
• Source: GoPro
• Source: Ivideon
• Source: Hass
• Source: ISAPI
• Source: Nest
• Source: Ring
• Source: Roborock
• Source: Doorbird
• Source: WebRTC
• Source: WebTorrent
• Incoming sources
• Stream to camera
• Publish stream
• Preload stream
• Module: API
• Module: RTSP
• Module: RTMP
• Module: WebRTC
• Module: HomeKit
• Module: WebTorrent
• Module: ngrok
• Module: Hass
• Module: MP4
• Module: HLS
• Module: MJPEG
• Module: Log
• Security
• Codecs filters
• Codecs madness
• Codecs negotiation
• Projects using go2rtc
• Camera experience
• TIPS

Fast start

1. Download binary or use Docker or Home Assistant Add-on or Integration
2. Open web interface: http://localhost:1984/

Optionally:

• add your streams to config file
• setup external access to webrtc

Developers:

• write your own web interface
• integrate web api into your smart home platform

go2rtc: Binary

Download binary for your OS from latest release:

• go2rtc_win64.zip - Windows 10+ 64-bit
• go2rtc_win32.zip - Windows 10+ 32-bit
• go2rtc_win_arm64.zip - Windows ARM 64-bit
• go2rtc_linux_amd64 - Linux 64-bit
• go2rtc_linux_i386 - Linux 32-bit
• go2rtc_linux_arm64 - Linux ARM 64-bit (ex. Raspberry 64-bit OS)
• go2rtc_linux_arm - Linux ARM 32-bit (ex. Raspberry 32-bit OS)
• go2rtc_linux_armv6 - Linux ARMv6 (for old Raspberry 1 and Zero)
• go2rtc_linux_mipsel - Linux MIPS (ex. Xiaomi Gateway 3, Wyze cameras)
• go2rtc_mac_amd64.zip - macOS 11+ Intel 64-bit
• go2rtc_mac_arm64.zip - macOS ARM 64-bit
• go2rtc_freebsd_amd64.zip - FreeBSD 64-bit
• go2rtc_freebsd_arm64.zip - FreeBSD ARM 64-bit

Don't forget to fix the rights chmod +x go2rtc_xxx_xxx on Linux and Mac.

PS. The application is compiled with the latest versions of the Go language for maximum speed and security. Therefore, the minimum OS versions depend on the Go language.

go2rtc: Docker

The Docker container alexxit/go2rtc supports multiple architectures including amd64, 386, arm64, and arm. This container offers the same functionality as the Home Assistant Add-on but is designed to operate independently of Home Assistant. It comes preinstalled with FFmpeg and Python.

go2rtc: Home Assistant Add-on

1. Install Add-On:
   • Settings > Add-ons > Plus > Repositories > Add https://github.com/AlexxIT/hassio-addons
   • go2rtc > Install > Start
2. Setup Integration

go2rtc: Home Assistant Integration

WebRTC Camera custom component can be used on any Home Assistant installation, including HassWP on Windows. It can automatically download and use the latest version of go2rtc. Or it can connect to an existing version of go2rtc. Addon installation in this case is optional.

go2rtc: Dev version

Latest, but maybe unstable version:

• Binary: latest nightly release
• Docker: alexxit/go2rtc:master or alexxit/go2rtc:master-hardware versions
• Hass Add-on: go2rtc master or go2rtc master hardware versions

Configuration

• by default go2rtc will search go2rtc.yaml in the current work directory
• api server will start on default 1984 port (TCP)
• rtsp server will start on default 8554 port (TCP)
• webrtc will use port 8555 (TCP/UDP) for connections
• ffmpeg will use default transcoding options

Configuration options and a complete list of settings can be found in the wiki.

Available modules:

• streams
• api - HTTP API (important for WebRTC support)
• rtsp - RTSP Server (important for FFmpeg support)
• webrtc - WebRTC Server
• mp4 - MSE, MP4 stream and MP4 snapshot Server
• hls - HLS TS or fMP4 stream Server
• mjpeg - MJPEG Server
• ffmpeg - FFmpeg integration
• ngrok - ngrok integration (external access for private network)
• hass - Home Assistant integration
• log - logs config

Module: Streams

go2rtc supports different stream source types. You can config one or multiple links of any type as a stream source.

Available source types:

• rtsp - RTSP and RTSPS cameras with two-way audio support
• rtmp - RTMP streams
• http - HTTP-FLV, MPEG-TS, JPEG (snapshots), MJPEG streams
• onvif - get camera RTSP link and snapshot link using ONVIF protocol
• ffmpeg - FFmpeg integration (HLS, files and many others)
• ffmpeg:device - local USB Camera or Webcam
• exec - get media from external app output
• echo - get stream link from bash or python
• expr - get stream link via built-in expression language
• homekit - streaming from HomeKit Camera
• bubble - streaming from ESeeCloud/dvr163 NVR
• dvrip - streaming from DVR-IP NVR
• eseecloud - streaming from ESeeCloud/dvr163 NVR
• tapo - TP-Link Tapo cameras with two way audio support
• ring - Ring cameras with two way audio support
• tuya - Tuya cameras with two way audio support
• xiaomi - Xiaomi cameras with two way audio support
• kasa - TP-Link Kasa cameras
• gopro - GoPro cameras
• ivideon - public cameras from Ivideon service
• hass - Home Assistant integration
• isapi - two-way audio for Hikvision (ISAPI) cameras
• roborock - Roborock vacuums with cameras
• doorbird - Doorbird cameras with two way audio support
• webrtc - WebRTC/WHEP sources
• webtorrent - WebTorrent source from another go2rtc
• wyze - Wyze cameras with two way audio support

Read more about incoming sources

Two-way audio

Supported sources:

• RTSP cameras with ONVIF Profile T (back channel connection)
• DVRIP cameras
• TP-Link Tapo cameras
• Hikvision ISAPI cameras
• Roborock vacuums models with cameras
• Doorbird cameras
• Exec audio on server
• Ring cameras
• Tuya cameras
• Wyze cameras
• Xiaomi cameras
• Any Browser as IP-camera

Two-way audio can be used in browser with WebRTC technology. The browser will give access to the microphone only for HTTPS sites (read more).

go2rtc also supports play audio files and live streams on this cameras.

Source: RTSP

```yaml streams: sonoff_camera: rtsp://rtsp:12345678@192.168.1.123/av_stream/ch0 dahua_camera: - rtsp://admin:password@192.168.1.123/cam/realmonitor?channel=1&subtype=0&unicast=true&proto=Onvif - rtsp://admin:password@192.168.1.123/cam/realmonitor?channel=1&subtype=1#backchannel=0 amcrest_doorbell: - rtsp://username:password@192.168.1.1