NAME

       janus-pp-rec - Janus recordings post-processing utility.

SYNOPSIS

       janus-pp-rec [options] source.mjr [destination.[opus|ogg|mka|wav|webm|mkv|h264|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 be converted to a either a .webm or .mkv file, while H.264 frames can  only  be
       converted to a .mp4 or .mkv file instead. Right now, you can convert VP8/VP9 recordings to
       .webm/.mkv, H.264/H.265/AV1 recordings to .mp4/.mkv, G.711/G.722 recordings to .wav,  Opus
       recordings  to  .opus/.ogg/.mka,  and  Data  Channel  text recordings to .srt. Binary Data
       Channel recordings can be dumped to files of any extension.

OPTIONS

       -h, --help
              Print help and exit

       -V, --version
              Print version and exit

       -F, --file-extensions
              Only print the supported target file extensions per codec  (default=off)

       -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)

       -e, --extended-json
              Only print extended JSON report (automatically enables --json)  (default=off)

       -m, --metadata=metadata
              Save this metadata string in the target file

       -i, --ignore-first=count
              Number of first packets to ignore when processing, e.g., in case they're  cause  of
              issues (default=0)

       -P, --payload-type=pt
              Ignore all RTP packets that don't match the specified payload type (default=none)

       -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", "ogg", "mka", "wav", "webm", "mkv", "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)

       -C, --silence-distance=count
              RTP packets distance  used  to  detect  RTP  silence  suppression,  disabled  if  0
              (default=0)

       -r, --restamp=count
              If   the  latency  of  a  packet  is  bigger  than  the  `moving_average_latency  *
              (<restamp>/1000)` the timestamps will be corrected, disabled if 0 (default=0)

       -c, --restamp-packets=count
              Number of packets  used  for  calculating  moving  average  latency  for  timestamp
              correction. (default=10)

       -n, --restamp-min-th=milliseconds
              Minimum  latency  of moving average to reach before starting to correct timestamps.
              If the current latency is below this threshold the timestamps will not be  changed.
              Below the threshold we ignore the moving average. (default=500)

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

       janus-pp-rec  --restamp=1500  rec1234.mjr  rec1234.opus  - Convert audio .mjr recording to
       .opus while RTP correcting timestamps based on moving average latency

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
       https://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

       https://janus.conf.meetecho.com - Demos and documentation

       https://groups.google.com/forum/#!forum/meetecho-janus - Community

       https://www.meetecho.com/blog/ - Tutorials and blog posts on Janus

AUTHORS

       Lorenzo Miniero (lorenzo@meetecho.com)

                                                                                  JANUS-PP-REC(1)