gortsplib

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

Go ≥ 1.15 is required.

Features:

• Client
  • Query servers about available streams
  • Read
    • Read streams from servers with UDP, UDP-multicast, TCP or TLS
    • Switch protocol automatically (switch to TCP in case of server error or UDP timeout)
    • Read only selected tracks of a stream
    • Pause or seek without disconnecting from the server
    • Generate RTCP receiver reports automatically
  • Publish
    • Publish streams to servers with UDP, TCP or TLS
    • Switch protocol automatically (switch to TCP in case of server error)
    • Pause without disconnecting from the server
    • Generate RTCP sender reports automatically
• Server
  • Handle requests from clients
  • Sessions and connections are independent
  • Read streams from clients with UDP, TCP or TLS
  • Write streams to clients with UDP, UDP-multicast, TCP or TLS
  • Provide SSRC, RTP-Info to clients automatically
  • Generate RTCP receiver reports automatically
• Utilities
  • Encode and decode RTSP primitives, RTP/H264, RTP/AAC, SDP

Table of contents

• Examples
• API Documentation
• Links

Examples

• client-query
• client-read
• client-read-partial
• client-read-options
• client-read-pause
• client-read-h264
• client-read-save-to-disk
• client-publish
• client-publish-options
• client-publish-pause
• server
• server-tls

API Documentation

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

Links

Related projects

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

IETF 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

Conventions

• https://github.com/golang-standards/project-layout