Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mbullington/yellowstone
:mount_fuji: The RTP/RTSP client for Node.js.
https://github.com/mbullington/yellowstone
node onvif rtsp
Last synced: about 1 month ago
JSON representation
:mount_fuji: The RTP/RTSP client for Node.js.
- Host: GitHub
- URL: https://github.com/mbullington/yellowstone
- Owner: mbullington
- License: mit
- Created: 2015-06-08T00:17:56.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-06-10T13:23:49.000Z (3 months ago)
- Last Synced: 2024-07-09T10:19:22.919Z (2 months ago)
- Topics: node, onvif, rtsp
- Language: TypeScript
- Homepage:
- Size: 582 KB
- Stars: 145
- Watchers: 11
- Forks: 58
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
yellowstone v3.0.4
===
[](https://www.npmjs.com/package/yellowstone)
The RTP/RTSP client for Node.js.
```
npm install yellowstone --save
```
## Getting Started
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.
## Current Features
- 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
## Examples
An example of most API features can be found at [examples/wowza.js](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.
```sh
ffmpeg -f h264 -i bigbuckbunny.264 -vcodec copy bigbuckbunny.mp4
```
The 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.
## Documentation
You can find auto-generated documentation in the [docs](docs/README.md) folder.
Documentation can be re-generated with
```npm run typedoc```
## Building from source
Compile the Typescript source code to Javascrip (in the dist folder) using these commands:-
```npm install
npm run build
```
## Contributing
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.