默认构建静态库,需要动态库要显式打开 SMOLRTSP_SHARED;示例服务器默认只推 H.264 与 G.711,JPEG XS/AV1/VVC 需分别加 -DENABLE_JPEGXS=ON 等编译开关;库本身不含网络后端,需自行接入 POSIX socket 或额外引入 smolrtsp-libevent 等集成。

include(FetchContent)
FetchContent_Declare(
smolrtsp
URL https://github.com/OpenIPC/smolrtsp/archive/refs/tags/v1.2.3.tar.gz # v1.2.3
)
FetchContent_MakeAvailable(smolrtsp)
target_link_libraries(MyProject smolrtsp)README 未说明具体硬件要求,仅说明面向 IP 摄像头等嵌入式设备设计。
面向 IP 摄像头等嵌入式设备的轻量 RTSP 1.0 服务端库,帮你快速搭起视频流服务
面向 IP 摄像头的轻量级实时流媒体 C 库,实现 RTSP/RTP 协议,可在嵌入式设备上做低开销的音视频推拉流。
核心能力
- 实现 RTSP 1.0 与 RTP/RTCP 协议栈
- 支持 RTP over TCP 交织与 RTP over UDP 两种传输
- 解析过程零拷贝,不额外分配或复制数据
- 支持 H.264/H.265/H.266/JPEG XS/AV1 载荷格式
- 不绑定网络框架,可搭配裸 POSIX socket 或 libevent
容易踩的坑
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。

SmolRTSP
SmolRTSP is a simple RTSP 1.0 server library tailored for embedded devices, such as IP cameras. It supports both TCP and UDP, allows any payload format, and provides a convenient and flexible API.
Highlights
- Small. SmolRTSP is designed for use in embedded systems (e.g., IP cameras).
- Unopinionated. You can use SmolRTSP with bare POSIX sockets, libevent, or any other network framework.
- Zero-copy. SmolRTSP does not allocate or copy data while parsing.
- Battle-tested. SmolRTSP is used by Majestic, an IP camera streamer developed by OpenIPC.
Features
- Supported protocols:
- Supported RTP payload formats:
- H.264 (RFC 6184)
- H.265 (RFC 7798)
- H.266 / VVC (RFC 9328)
- JPEG XS (RFC 9134) -- codestream and slice packetization modes
- AV1 (AOMedia AV1 RTP) -- one OBU per packet with Z/Y fragmentation
Installation
If you use CMake, the recommended way is FetchContent:
include(FetchContent)
FetchContent_Declare(
smolrtsp
URL https://github.com/OpenIPC/smolrtsp/archive/refs/tags/v1.2.3.tar.gz # v1.2.3
)
FetchContent_MakeAvailable(smolrtsp)
target_link_libraries(MyProject smolrtsp)
Options
| Option | Description | Default |
|---|---|---|
SMOLRTSP_SHARED | Build a shared library instead of static. | OFF |
SMOLRTSP_FULL_MACRO_EXPANSION | Show full macro expansion backtraces (DANGEROUS: may impair diagnostics and slow down compilation). | OFF |
Usage
A simple example server that streams H.264 video and G.711 Mu-Law audio can be found at examples/server.c. The same server can also advertise additional streams: pass -DENABLE_JPEGXS=ON for JPEG XS on the /jpegxs path, -DENABLE_AV1=ON for AV1 on the /av1 path, or -DENABLE_VVC=ON for H.266 / VVC on the /vvc path.

Run it as follows:
$ mkdir examples/build
$ cd examples/build
$ cmake .. && cmake --build .
$ sudo ./server
Then open a new terminal window to start playing:
$ ffplay rtsp://localhost
Integration
SmolRTSP is agnostic to a network backend: you can run it atop of any network/event loop framework. Currently, we support the following integrations:
Feel free to extend this list with your own integration code.
Release procedure
- Update the
PROJECT_NUMBERfield inDoxyfile. - Update
CHANGELOG.md. - Release the project in GitHub Releases.