other versions
- buster-backports 0.9.2-1~bpo10+1
- unstable 0.11.2-1
- experimental 0.11.3-1~exp1
JANUS-PP-REC(1) | General Commands Manual | JANUS-PP-REC(1) |
NAME¶
janus-pp-rec - Janus recordings post-processing utility.SYNOPSIS¶
janus-pp-rec [options] source.mjr [destination.[opus|wav|webm|mp4|srt]]DESCRIPTION¶
janus-pp-rec is a simple utility that allows you to post-process recordings generated by Janus plugins (e.g., VideoRoom or others). More specifically, since Janus recordings (.mjr files) are basically a structured dump of RTP packets, this utility reorders them all and extracts the frames in order to stick them together and save them to a playable media file. No transcoding is done.- The target file depends on the codec used in the recording: for instance, VP8 and VP9 frames can only be converted to a .webm file, while H.264 frames can only be converted to a .mp4 file. Right now, you can convert VP8/VP9 recordings to .webm, H.264 recordings to .mp4, G.711 recordings to .wav, Opus recordings to .opus and Data Channel recordings to .srt.
OPTIONS¶
- -h, --help
- Print help and exit
- -V, --version
- Print version and exit
- -j, --json
- Only print JSON header (default=off)
- -H, --header
- Only parse .mjr header (default=off)
- -p, --parse
- Only parse and re-order packets (default=off)
- -m, --metadata=metadata
- Save this metadata string in the target file
- -r, --postreset-trigger=count
- Number of packets needed to detect a timestamp reset (default=200)
- -i, --ignore-first=count
- Number of first packets to ignore when processing, e.g., in case they're cause of issues (default=0)
- -a, --audiolevel-ext=id
- ID of the audio-levels RTP extension (default=none)
- -v, --videoorient-ext=id
- ID of the video-orientation RTP extension (default=none)
- -d, --debug-level=1-7
- Debug/logging level (0=disable debugging, 7=maximum debug level; default=4)
- -D, --debug-timestamps
- Enable debug/logging timestamps (default=off)
- -o, --disable-colors
- Disable color in the logging (default=off)
- -f, --format=STRING
- Specifies the output format (overrides the format from the destination) (possible values="opus", "wav", "webm", "mp4", "srt")
- -t, --faststart
- For mp4 files write the MOOV atom at the head of the file (default=off)
- -S, --audioskew=milliseconds
- Time threshold to trigger an audio skew compensation, disabled if 0 (default=0)
EXAMPLES¶
janus-pp-rec --header rec1234.mjr - Parse the recordings header (shows metadata info)- janus-pp-rec --parse rec1234.mjr - Parse the recordings packets without processing them
- janus-pp-rec rec1234.mjr rec1234.webm - Convert a VP8 .mjr recording to a .webm file
BUGS¶
- If you think you found a bug or want to contribute a feature, you can issue or a pull request on https://github.com/meetecho/janus-gateway/issues.
- Anyway, before doing that make sure you read the documentation at http://janus.conf.meetecho.com/docs/ and that it has not been discussed already at https://groups.google.com/forum/#!forum/meetecho-janus. We only use Github for code issues, and NOT for configuration or usage issues: use the group for that.
SEE ALSO¶
- https://github.com/meetecho/janus-gateway - Official repository
- http://janus.conf.meetecho.com - Demos and documentation
- https://groups.google.com/forum/#!forum/meetecho-janus - Community
- http://www.meetecho.com/blog/ - Tutorials and blog posts on Janus