frankurcrazy/gortsplib

RTSP 1.0 client and server library for the Go programming language

gortsplib

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

Go ≥ 1.17 is required.

Features:

• Client
  • Query servers about available streams and tracks
  • Read
    • Read 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 tracks of a stream
    • Pause or seek without disconnecting from the server
    • Generate RTCP receiver reports (UDP only)
    • Reorder incoming RTP packets (UDP only)
  • Publish
    • Publish 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 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 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 codec-specific frames into/from RTP packets. The following codecs are supported:
    • Video
      • H264
      • H265
      • VP8
      • VP9
    • Audio
      • G722
      • LPCM
      • MPEG4-audio (AAC)
      • Opus
      • PCMA
      • PCMU
  • 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

Table of contents

• Examples
• API Documentation
• Links

Examples

• client-query
• client-read
• client-read-codec-g722
• client-read-codec-h264
• client-read-codec-h264-convert-to-jpeg
• client-read-codec-h264-save-to-disk
• client-read-codec-h265
• client-read-codec-lpcm
• client-read-codec-mpeg4audio
• client-read-codec-opus
• client-read-codec-pcma
• client-read-codec-pcmu
• client-read-codec-vp8
• client-read-codec-vp9
• client-read-partial
• client-read-options
• client-read-pause
• client-read-republish
• client-publish-codec-g722
• client-publish-codec-h264
• client-publish-codec-h265
• client-publish-codec-lpcm
• client-publish-codec-mpeg4audio
• client-publish-codec-opus
• client-publish-codec-pcma
• client-publish-codec-pcmu
• client-publish-codec-vp8
• client-publish-codec-vp9
• client-publish-options
• client-publish-pause
• server
• server-tls
• server-h264-save-to-disk

API Documentation

https://pkg.go.dev/github.com/aler9/gortsplib#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