package/gortsplib
1
0
Fork 0
mirror of https://github.com/aler9/gortsplib synced 2025-10-06 07:37:07 +08:00
Code Issues Packages Projects Releases Wiki Activity
1,539 Commits 7 Branches 84 Tags
a29348e65fd06e71bca16a8d0fcf9ea0a1e1f35a
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
Alessandro Ros a29348e65f update mediacommon (#424)
2023-09-16 22:58:58 +02:00
.github
Merge branch 'main' into v4
2023-08-23 18:47:52 +02:00
examples
add client-read-format-av1 example (#399)
2023-09-02 15:10:50 +02:00
internal/highleveltests
allow setting additional properties of streams through description.Stream
2023-08-22 16:46:18 +02:00
pkg
multicast: add readOnly flag (#423)
2023-09-16 11:03:32 +02:00
scripts
update gofumpt
2023-08-12 20:20:01 +02:00
.dockerignore
initial commit
2020-01-20 10:15:24 +01:00
.gitignore
add codecov
2021-02-13 20:13:19 +01:00
.golangci.yml
fix reading and writing multicast packets in case of multiple interfaces (#413)
2023-09-11 23:36:53 +02:00
async_processor.go
make WritePacket*() return errors when write queue is full (#388)
2023-08-26 18:09:45 +02:00
client_format.go
move most errors into pkg/liberrors (#408)
2023-09-10 17:32:16 +02:00
client_media.go
fix reading and writing multicast packets in case of multiple interfaces (#413)
2023-09-11 23:36:53 +02:00
client_play_test.go
client: support cameras that don't reply to keepalives (#412)
2023-09-11 17:49:46 +02:00
client_reader.go
client: fix race condition that can lead to crash (#407)
2023-09-10 16:57:40 +02:00
client_record_test.go
check SPS/PPS of H264/H265 SDPs (#394)
2023-09-01 18:31:52 +02:00
client_test.go
client: support server-sent requests (#93) (#378)
2023-08-24 16:07:09 +02:00
client_udp_listener.go
optimize multicast on Linux by listening on a single IP (#417)
2023-09-13 22:55:20 +02:00
client.go
fix reading and writing multicast packets in case of multiple interfaces (#413)
2023-09-11 23:36:53 +02:00
constants.go
fix reading and writing multicast packets in case of multiple interfaces (#413)
2023-09-11 23:36:53 +02:00
empty_timer.go
normalize file names (#173)
2023-01-22 11:44:20 +01:00
go.mod
update mediacommon (#424)
2023-09-16 22:58:58 +02:00
go.sum
update mediacommon (#424)
2023-09-16 22:58:58 +02:00
LICENSE
Initial commit
2020-01-20 10:08:25 +01:00
Makefile
update Linux Alpine
2023-08-12 20:19:54 +02:00
README.md
remove useless SO_REUSEPORT (#422)
2023-09-15 22:32:20 +02:00
restrict_network.go
do not listen on IPv6 when host is 0.0.0.0 (#240)
2023-04-10 22:42:19 +02:00
server_conn_reader.go
client: support server-sent requests (#93) (#378)
2023-08-24 16:07:09 +02:00
server_conn.go
client: support server-sent requests (#93) (#378)
2023-08-24 16:07:09 +02:00
server_handler.go
client: add OnServerRequest and OnServerResponse callbacks (#405)
2023-09-10 16:28:10 +02:00
server_multicast_writer.go
make WritePacket*() return errors when write queue is full (#388)
2023-08-26 18:09:45 +02:00
server_play_test.go
client: support server-sent requests (#93) (#378)
2023-08-24 16:07:09 +02:00
server_record_test.go
move most errors into pkg/liberrors (#408)
2023-09-10 17:32:16 +02:00
server_session_format.go
move most errors into pkg/liberrors (#408)
2023-09-10 17:32:16 +02:00
server_session_media.go
move most errors into pkg/liberrors (#408)
2023-09-10 17:32:16 +02:00
server_session.go
server: stop sending multicast packets when all multicast readers have disconnected (#411)
2023-09-11 10:57:49 +02:00
server_stream_format.go
make WritePacket*() return errors when write queue is full (#388)
2023-08-26 18:09:45 +02:00
server_stream_media.go
server: stop sending multicast packets when all multicast readers have disconnected (#411)
2023-09-11 10:57:49 +02:00
server_stream.go
server: stop sending multicast packets when all multicast readers have disconnected (#411)
2023-09-11 10:57:49 +02:00
server_tcp_listener.go
move each goroutine in a dedicated struct (#285)
2023-05-17 21:14:00 +02:00
server_test.go
allow setting additional properties of streams through description.Stream
2023-08-22 16:46:18 +02:00
server_udp_listener.go
multicast: add readOnly flag (#423)
2023-09-16 11:03:32 +02:00
server.go
move most errors into pkg/liberrors (#408)
2023-09-10 17:32:16 +02:00
transport_test.go
rename ClientTransport into Transport
2021-10-22 17:53:51 +02:00
transport.go
update docs
2022-05-10 10:28:52 +02:00

README.md

gortsplib

Test Lint Go Report Card CodeCov PkgGoDev

RTSP 1.0 client and server library for the Go programming language, written for MediaMTX.

Go ≥ 1.19 is required.

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 selected media streams only
      • Pause or seek without disconnecting from the server
      • Get PTS (relative) timestamp of incoming packets
      • Get NTP (absolute) timestamp of incoming packets
    • 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
  • Server
    • Handle requests from clients
    • Publish
      • Read media streams from clients with the UDP or TCP transport protocol
      • Read TLS-encrypted streams (TCP only)
      • Get PTS (relative) timestamp of incoming packets
      • Get NTP (absolute) timestamp of incoming packets
    • Read
      • Write media streams to clients with the UDP, UDP-multicast or TCP transport protocol
      • Write TLS-encrypted streams (TCP only)
      • Compute and provide SSRC, RTP-Info to clients
  • Utilities
    • Parse RTSP elements
    • Encode/decode codec-specific frames into/from RTP packets

Table of contents

Examples

API Documentation

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

RTP Payload Formats

In RTSP, media streams are routed between server and clients by using RTP packets. Conversion between RTP packets and codec-specific frames happens by using a payload format. This library recognizes the following payload formats:

Video

format / codec variant documentation encoder and decoder available
AV1 link ✔️
VP9 link ✔️
VP8 link ✔️
H265 link ✔️
H264 link ✔️
MPEG-4 Video (H263, Xvid) link ✔️
MPEG-1/2 Video link ✔️
M-JPEG link ✔️

Audio

format / codec variant documentation encoder and decoder available
Opus link ✔️
Vorbis link
MPEG-4 Audio (AAC) Generic (RFC3640) link ✔️
MPEG-4 Audio (AAC) LATM (RFC6416) link ✔️
MPEG-1/2 Audio (MP3) link ✔️
Speex link
G726 link
G722 link ✔️
G711 (PCMA, PCMU) link ✔️
LPCM link ✔️

Other

format / codec variant documentation encoder and decoder available
MPEG-TS link

Specifications

name area
RFC2326, RTSP 1.0 protocol
RFC7826, RTSP 2.0 protocol
RFC8866, SDP: Session Description Protocol SDP
RFC3551, RTP Profile for Audio and Video Conferences with Minimal Control G726, G722, G711 payload formats
RFC2250, RTP Payload Format for MPEG1/MPEG2 Video MPEG-1 video, MPEG-2 audio, MPEG-TS payload formats
RFC2435, RTP Payload Format for JPEG-compressed Video M-JPEG payload format
RFC6416, RTP Payload Format for MPEG-4 Audio/Visual Streams MPEG-4 audio payload format
RFC6184, RTP Payload Format for H.264 Video H264 payload format
RFC7798, RTP Payload Format for High Efficiency Video Coding (HEVC) H265 payload format
RFC7741, RTP Payload Format for VP8 Video VP8 payload format
RTP Payload Format for VP9 Video VP9 payload format
RFC3190, RTP Payload Format for 12-bit DAT Audio and 20- and 24-bit Linear Sampled Audio LPCM payload format
RFC5215, RTP Payload Format for Vorbis Encoded Audio Vorbis payload format
RFC7587, RTP Payload Format for the Opus Speech and Audio Codec Opus payload format
RFC3640, RTP Payload Format for Transport of MPEG-4 Elementary Streams MPEG-4 audio, MPEG-4 video payload formats
RFC5574, RTP Payload Format for the Speex Codec Speex payload format
RTP Payload Format For AV1 (v1.0) AV1 payload format
Codec specifications codecs
Golang project layout project layout

Related projects

Description
No description provided
Readme MIT 15 MiB
Languages
Go 99.8%
Makefile 0.2%