Skip to main content

ROS Live RTSP Manager

Configure ROS image topics exposed as managed local RTSP streams.

nimbus ros-live-rtsp <command>
CommandDescription
listShow current ROS live RTSP settings
export <path>Export ROS live RTSP settings to JSON
import <path>Import ROS live RTSP settings from JSON and apply them

ROS2 DDS domain id is resolved from the agent ROS config at runtime. Do not put domainId in the live RTSP settings JSON. The server listener is fixed internally at 0.0.0.0:8554.

list, import, and export operate only on stream settings. Shared viewer credentials are robot-local startup configuration in nimbus.json, not CLI-managed settings:

{
"rosLiveRtspCredentials": {
"username": "viewer",
"password": "replace-with-a-strong-password"
}
}

Protect nimbus.json and its backups because they contain the raw password. Restart the agent service after changing these credentials. Runtime status and metric views expose only the viewer username and credential availability, never the password.

Example

nimbus ros-live-rtsp export /tmp/ros-live-rtsp.json
nimbus ros-live-rtsp import /tmp/ros-live-rtsp.json
nimbus ros-live-rtsp list

Example JSON for /cogniteam_ros2_sim/compressed_image:

{
"items": [
{
"id": "cogniteam-ros2-sim",
"name": "Cogniteam ROS2 Sim",
"enabled": true,
"rtspPath": "cogniteam_ros2_sim/compressed_image",
"source": {
"ros2Topic": {
"name": "/cogniteam_ros2_sim/compressed_image",
"type": "sensor_msgs/msg/CompressedImage"
}
}
}
]
}