Skip to main content

mrg-iot stream

Camera-equipped devices are proxied over RTSP. list, open, and url watch them; push sends video the other way, into a device. capture streams the experiment's live network traffic into Wireshark.

mrg-iot stream --help showing the open, list, url, and push subcommands

Streams hold a tunnel open​

A stream is continuous, so open, url, push, and capture keep running to hold their tunnel open; closing the command closes the feed. The local port is assigned per session, which is why stream list prints a <port> placeholder.

Requirements​

  • stream open needs VLC.
  • stream push needs ffmpeg.
  • stream capture needs Wireshark, unless it writes to a file with --write.

Flags​

Every command that talks to a running experiment takes the same four experiment flags, each with a default, so you usually pass only -e:

ArgumentDescription
--project, -pProject name. Default: your only project; required when you belong to several.
--experiment, -eExperiment name. Default: your username.
--realization, -rRealization name. Default: realiot.
--xdc, -xXDC name. Default: <experiment>xdc.

Commands​

CommandWhat it does
stream listName the experiment's cameras.
stream openVLC viewers for every camera.
stream urlPrint the RTSP URLs and keep forwarding.
stream pushSend a video stream to a device.
stream captureWatch the experiment's live traffic in Wireshark.

Back to the full walkthrough: Using mrg-iot.