Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/scottlamb/retina
High-level RTSP multimedia streaming library, in Rust
https://github.com/scottlamb/retina
ip-camera rtsp rust
Last synced: about 2 months ago
JSON representation
High-level RTSP multimedia streaming library, in Rust
- Host: GitHub
- URL: https://github.com/scottlamb/retina
- Owner: scottlamb
- License: apache-2.0
- Created: 2021-06-03T23:36:23.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-06T17:46:13.000Z (7 months ago)
- Last Synced: 2024-03-15T22:10:07.875Z (6 months ago)
- Topics: ip-camera, rtsp, rust
- Language: Rust
- Homepage: https://crates.io/crates/retina
- Size: 635 KB
- Stars: 199
- Watchers: 5
- Forks: 41
- Open Issues: 37
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE.txt
Awesome Lists containing this project
README
# retina
[](https://crates.io/crates/retina)
[](https://docs.rs/retina)
[](https://github.com/scottlamb/retina/actions?query=workflow%3ACI)
High-level RTSP multimedia streaming library, in Rust. Good support for
ONVIF RTSP/1.0 IP surveillance cameras, as needed by
[Moonfire NVR](https://github.com/scottlamb/moonfire-nvr). Works around
brokenness in cheap closed-source cameras.
Status: In production use in Moonfire NVR. Many missing features.
Progress:
* [x] client support
* [x] basic authentication.
* [x] digest authentication.
* [x] RTP over TCP via RTSP interleaved channels.
* [x] RTP over UDP (experimental).
* * [ ] re-order buffer. (Out-of-order packets are dropped now.)
* [x] RTSP/1.0.
* [ ] RTSP/2.0.
* [ ] SRTP.
* [ ] ONVIF backchannel support (for sending audio).
* [ ] ONVIF replay mode.
* [x] receiving RTCP Sender Reports (currently only uses the timestamp)
* [ ] sending RTCP Receiver Reports
* [ ] server support
* I/O modes
* [x] async with tokio
* [ ] async-std
* [ ] synchronous with std only
* codec depacketization
* [x] video
* [x] H.264
* [ ] SVC
* [ ] periodic infra refresh
* [x] multiple slices per picture
* [ ] multiple SPS/PPS
* [ ] interleaved mode
* [x] AAC output format
* [ ] Annex B output format ([#44](https://github.com/scottlamb/retina/issues/44))
* [x] ([RFC 6184](https://datatracker.ietf.org/doc/html/rfc6184))
* [x] MJPEG
* [x] ([RFC 2435](https://datatracker.ietf.org/doc/html/rfc2435))
* audio
* [x] AAC
* [ ] interleaving
* [x] [RFC 3551](https://datatracker.ietf.org/doc/html/rfc3551)
codecs: G.711, G.723, L8/L16
* [x] application: ONVIF metadata
* [ ] clean, stable API. (See [#47](https://github.com/scottlamb/retina/issues/47).)
* quality errors
* * [x] detailed error description text.
* * [ ] programmatically inspectable error type.
* [ ] good functional testing coverage. (Currently lightly / unevenly tested.
Most depacketizers have no tests.)
* [ ] fuzz testing. (In progress.)
* [x] benchmark
Help welcome!
## Getting started
Try the `mp4` example. It streams from an RTSP server to a `.mp4` file until
you hit ctrl-C.
```shell
$ cargo run --package client mp4 --url rtsp://ip.address.goes.here/ --username admin --password test out.mp4
...
^C
```
## Example client
```shell
$ cargo run --package client
```
Where CMD:
* **info** - Gets info about available streams and exits.
* **mp4** - Writes RTSP streams to mp4 file; exit with Ctrl+C.
* **onvif** - Gets realtime onvif metadata if available; exit with Ctrl+C.
* **jpeg** - Writes depacketized JPEG images to disk; exit with CTRL+C.
## Example WebRTC proxy
This allows viewing a H.264 video stream from your browser, with the help of
[`webrtc-rs`](https://crates.io/crates/webrtc).
```shell
$ cargo run --package webrtc-proxy -- --help
```
## Acknowledgements
This builds on the whole Rust ecosystem. A couple folks have been especially
helpful:
* Sebastian Dröge, author of
[`rtsp-types`](https://crates.io/crates/rtsp-types)
* David Holroyd, author of
[`h264-reader`](https://crates.io/crates/h264-reader)
## Why "retina"?
It's a working name. Other ideas welcome. I started by looking at dictionary
words with the letters R, T, S, and P in order and picking out ones related to
video:
| `$ egrep '^r.*t.*s.*p' /usr/share/dict/words'` | |
| ---------------------------------------------- | ---------------------------------------------------------------------------- |
| retinoscope | close but too long, thus `retina` |
| retrospect | good name for an NVR, but I already picked Moonfire |
| rotascope | misspelling of "rotascope" (animation tool) or archaic name for "gyroscope"? |
## License
Your choice of MIT or Apache; see [LICENSE-MIT.txt](LICENSE-MIT.txt) or
[LICENSE-APACHE](LICENSE-APACHE.txt), respectively.