rtsp-curl

Python RTSP client built on libcurl via pycurl. Supports OPTIONS / DESCRIBE / SETUP / PLAY / TEARDOWN over UDP (default) or TCP.

Requirements

• Python 3.9+
• libcurl with RTSP support (curl --version | grep rtsp)
• pycurl >= 7.45.0

Installation

pip install rtsp-curl-mad

macOS (custom OpenSSL required by pycurl):

PYCURL_SSL_LIBRARY=openssl \
  LDFLAGS="-L/usr/local/opt/openssl/lib" \
  CPPFLAGS="-I/usr/local/opt/openssl/include" \
  pip install --no-cache-dir pycurl

pip install rtsp-curl-mad

Quick start

import time
from madyel import RtspCurl

URL = "rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov"

client = RtspCurl()
client.init(URL, "user:password")

client.rtsp_options()
client.auth()
client.rtsp_describe()

control = client.get_media_control_attribute()
client.rtsp_setup(control)
client.rtsp_play(URL)

time.sleep(10)          # stream for 10 seconds

client.rtsp_teardown()
client.rtsp_curl_close()

API reference

RtspCurl(*, debug=False, tcp=False)

Methods

Storage

Helper that accumulates pycurl callback data line by line.

from madyel import Storage

buf = Storage()
# pass buf.store as pycurl WRITEFUNCTION / HEADERFUNCTION
print(buf)   # all accumulated lines

Options

Debug mode — enables pycurl.VERBOSE (full headers and timing on stderr):

client = RtspCurl(debug=True)

TCP transport — by default the client negotiates RTP over UDP:

client = RtspCurl(tcp=True)

Publishing a new release

Tag the commit — GitHub Actions builds and uploads to PyPI automatically:

git tag v0.9.1
git push origin v0.9.1

One-time setup: configure the PyPI Trusted Publisher at https://pypi.org/manage/project/rtsp-curl-mad/settings/publishing/

License

MIT