The RTP/RTSP client for Node.js.
npm install yellowstone --save
Yellowstone is a library to receive video, andio and metadata from RTSP/RTP sources including Wowza and IP Cameras. The library can parse some common video and audio transport formats and delivers the (often compressed) video and audio data to the library user, or writes it to a file. The library doe not include codec decoders.
Yellowstone was co-developed by Michael Bullington and Roger Hardiman.
- Receive Raw RTP/AVP via UDP & TCP (interleaved)
- Basic and Digest Authentication
- Pause, Play, and Teardown (Close)
- H264/AAC transport parsing (and writing video to a .264 file)
- H265/HEVC transport parsing (and writing video to a .265 file)
- AAC transport paring (and writing audio to an .aac file)
- ONVIF Metadata parsing (and writing to an output file)
- ONVIF extensions to RTSP
- ONVIF Audio Backchannel, sending ALaw audio to an IP Camera
- Simple RTCP parsing
An example of most API features can be found at examples/wowza.js, which will create
a file named bigbuckbunny.264 in the project's root directory. To test this file with a
video player, you either need a video player that supports raw H264 frames, or wrap it
in a container like MP4.
You can play the video with
ffplay bigbuckbunny.264
While yellowstone is /not/ dependent on ffmpeg, converting the file to an .mp4 can be easily accomplished with the following command.
ffmpeg -f h264 -i bigbuckbunny.264 -vcodec copy bigbuckbunny.mp4The audio backchannel example from vietelle-solutions can connect to an ONVIF camera and send a .alaw audio file to the camera
It plays a clip from the Monty Python's Holy Grail.
An alaw file can be played with
ffplay -f alaw -ar 8k -ac 1 audio.alaw
If you wish to play the H264 file directly, I've had good experience personally with the IINA video player for macOS. VLC and FFPLAY also work.
You can find auto-generated documentation in the docs folder.
Documentation can be re-generated with
npm run typedoc
Compile the Typescript source code to Javascrip (in the dist folder) using these commands:-
npm run build
Please contribute features!
Yellowstone covers a very small subset of what's possible with RTSP/RTP. Feel free to write and submit pull requests for new features and bug fixes.