Scroll to navigation

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

AUTHORS

Lorenzo Miniero (lorenzo@meetecho.com)