gortsplib

RTSP 1.0 client and server library for the Go programming language, written for rtsp-simple-server.

Go ≥ 1.17 is required.

WARNING: the main branch contains code of the v2 version. The legacy v1 version is hosted in the v1 branch.

Features:

Client
- Query servers about available media streams
- Read
  - Read media streams from servers with the UDP, UDP-multicast or TCP transport protocol
  - Read TLS-encrypted streams (TCP only)
  - Switch transport protocol automatically
  - Read only selected media streams
  - Pause or seek without disconnecting from the server
  - Generate RTCP receiver reports (UDP only)
  - Reorder incoming RTP packets (UDP only)
- Publish
  - Publish media streams to servers with the UDP or TCP transport protocol
  - Publish TLS-encrypted streams (TCP only)
  - Switch transport protocol automatically
  - Pause without disconnecting from the server
  - Generate RTCP sender reports
Server
- Handle requests from clients
- Sessions and connections are independent
- Publish
  - Read media streams from clients with the UDP or TCP transport protocol
  - Read TLS-encrypted streams (TCP only)
  - Generate RTCP receiver reports (UDP only)
  - Reorder incoming RTP packets (UDP only)
- Read
  - Write media streams to clients with the UDP, UDP-multicast or TCP transport protocol
  - Write TLS-encrypted streams
  - Compute and provide SSRC, RTP-Info to clients
  - Generate RTCP sender reports
Utilities
- Encode and decode format-specific frames into/from RTP packets. The following formats are supported:
  - Video: H264, H265, VP8, VP9
  - Audio: G711 (PCMA, PCMU), G722, LPCM, MPEG4-audio (AAC), Opus
- Parse RTSP elements: requests, responses, SDP
- Parse H264 elements and formats: Annex-B, AVCC, anti-competition, DTS
- Parse MPEG4-audio (AAC) element and formats: ADTS, MPEG4-audio configurations

Examples

API Documentation

https://pkg.go.dev/github.com/aler9/gortsplib/v2#pkg-index

Links

Related projects

rtsp-simple-server https://github.com/aler9/rtsp-simple-server
pion/sdp (SDP library used internally) https://github.com/pion/sdp
pion/rtp (RTP library used internally) https://github.com/pion/rtp
pion/rtcp (RTCP library used internally) https://github.com/pion/rtcp

Standards

RTSP 1.0 https://tools.ietf.org/html/rfc2326
RTSP 2.0 https://tools.ietf.org/html/rfc7826
HTTP 1.1 https://tools.ietf.org/html/rfc2616
Golang project layout https://github.com/golang-standards/project-layout

Name		Name	Last commit message	Last commit date
Latest commit History 1,275 Commits
.github		.github
examples		examples
internal/highleveltests		internal/highleveltests
pkg		pkg
scripts		scripts
.dockerignore		.dockerignore
.gitignore		.gitignore
.golangci.yml		.golangci.yml
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
client.go		client.go
client_play_test.go		client_play_test.go
client_record_test.go		client_record_test.go
client_test.go		client_test.go
clientformat.go		clientformat.go
clientmedia.go		clientmedia.go
clientudpl.go		clientudpl.go
constants.go		constants.go
emptytimer.go		emptytimer.go
go.mod		go.mod
go.sum		go.sum
server.go		server.go
server_play_test.go		server_play_test.go
server_record_test.go		server_record_test.go
server_test.go		server_test.go
serverconn.go		serverconn.go
serverhandler.go		serverhandler.go
servermulticasthandler.go		servermulticasthandler.go
serversession.go		serversession.go
serversessionformat.go		serversessionformat.go
serversessionmedia.go		serversessionmedia.go
serverstream.go		serverstream.go
serverstreamformat.go		serverstreamformat.go
serverstreammedia.go		serverstreammedia.go
serverudpl.go		serverudpl.go
transport.go		transport.go
transport_test.go		transport_test.go
writer.go		writer.go

License

illuspas/gortsplib

Folders and files

Latest commit

History

Repository files navigation

gortsplib

Table of contents

Examples

API Documentation

Links

About

Resources

License

Stars

Watchers

Forks

Languages