How To Obtain and Utilize the Video Sub-Stream && Image Snapshots of MXnet 1G Endpoints on an AC-MXNET-CBOX-B/HA

How To: Obtain a MXnet 1G Encoder's video sub-stream URL && Image Snapshots to be utilized by Third Party Devices

This document describes how to obtain a URL that allows access to the Motion JPEG video sub-stream generated by a V2 encoder, as well as the method for utilizing a URL to download static image snapshots of V2 and V1 encoders.

Note: This only applies to AC-MXNET-CBOX-B/HA version V4.21 or higher, and only with MXnet V2 encoders for the video sub-stream. This feature is not applicable on AC-MXNET-CBOX hardware, and video sub-streams are not supported on V1 encoders. 

How to Grab the URL of a V2 Encoder's MJPEG Sub-Stream

Step One: Log into the MENTOR interface of the CBOX-HA.

Step Two: Navigate to the AUTO-MATRIX page.

Step Three: For the desired encoder, double click on the encoder’s image preview on the left side of the page.

Step Four: On the expanded image preview window that populates, right click the preview and select “copy image address”.

Sub-stream URL Breakdown

In the above example, the URL that was copied from the V2 encoder is shown below:

http://192.168.1.222:10088/?action=stream&w=960&h=540&fps=30&bw=8000&as=0&dev=188A6A01A04E&ip=169.254.216.114&port=8080

The URL can be broken down to the following parameters:

http://{CBOX IP Address}:{Encoder Port Number}/?action=stream&w={Width, up to 1280}&h={height, up to 720}&bw={Bandwidth allocation(in kbps)}&as=0&dev={Encoder MAC Address}&ip={Encoder IP Address}&port=8080

Knowing these parameter values, a user can build a URL to access a V2 encoder's sub-stream without manually copying from the CBOX. 

Note: The encoder's port number and IP address could be dynamically changed if the device is power cycled at a point in time. For a more permanent URL to utilize, the Encoder Port Number parameter can be replaced with 10085, and the Encoder can be statically assigned an IP address (even if still on a link-local/APIPA IP scheme).

Using the sub-stream outside of the CBOX

Paste the copied URL (or modified URL based on the description above) wherever is desired, such as VLC media player, a supported Control System, or a new web browser tab. The preview sub-stream will populate as long as said software or device can establish a network connection to the AC-MXNET-CBOX-HA.

Image Snapshots

A static .JPG image snapshot can also be downloaded from a V2 Encoder. To obtain an image snapshot, the following URL will need to be used:

NOTE: This URL is only for V2 encoders. See the next section for the URL for V1 encoder's image snapshots.

http://{CBOX IP Address}:10085/?action=snapshot&w={Width}&h={Height}&q={Quality}&as=0&dev={DeviceMAC}&ip={DeviceIP}&port=8080

1. {Width} == Desired Width in pixels for the image to be downloaded. Maximum is 1920. Default value is 1024.
2. {Height} == Desired Height in pixels for the image to be downloaded. Maximum is 1080. Default value is 576.
3. {Quality }== Overall quality of the image. Maximum parameter value is 100. Default is 60.
   
4. {DeviceMAC} == Device MAC address of the desired V2 endpoint. Can be read using the CBOX API command "config get devicelist", or "config get device info {EncoderCustomName}".
   
5. {DeviceIP} == Device IP Address of the desired V2 endpoint. Can be read using the CBOX API command "config get devicelist", or "config get device info {EncoderCustomName}".
   
1. NOTE: To save programming resources, it is recommended to set the encoder's IP address to static if image previews are being pulled outside of the CBOX, or the IP address will need to be periodically queried to safeguard the event that the Encoder's IP address changes (such as after a power cycle if self-sign IPs are used).
   

A URL example with the appropriate parameter values is shown below:

http://192.168.1.222:10085/?action=snapshot&w=1920&h=1080&q=100&as=0&dev=188A6A0251DD&ip=169.254.244.20&port=8080

If the parameter values above are simply placed with "x", default values will be used instead. For example, the URL below will automatically download a 1024x576, 60% quality image from the target V2 encoder:

http://192.168.1.222:10085/?action=snapshot&w=x&h=x&q=x&as=0&dev=188A6A0251DD&ip=169.254.244.20&port=8080

The constructed image URL can then be utilized as needed outside of the CBOX.

V1 Encoder Image Snapshot

V1 Encoder's static image snapshots can be grabbed in a similar manner to V2 encoders, but the URL is slightly different. A .BMP image file will be automatically downloaded as well. Example template URL Below:

http://{CBOXIP}:10085/capture.bmp?dev={DeviceMAC}&ip={DeviceIP}&port=80&t={EpochTimeStamp}

1. {CBOXIP} == IP address of the target AC-MXNET-CBOX-HA.
   
2. {DeviceMAC} == MAC Address of the target V1 Encoder.
   
3. {DeviceIP} == IP Address of the target V1 Encoder.
   
4. {EpochTimeStamp} == current date/time stamp, in UNIX EPOCH format. A unique UNIX epoch timestamp is required for dynamic image captures from V1 Encoders.

Example URL with the appropriate parameter values:

http://192.168.1.222:10085/capture.bmp?dev=188A6A0140BB&ip=169.254.6.9&port=80&t=1752252651805

The constructed image URL can then be utilized as needed outside of the CBOX.

• Related Articles

• MXnet 1G API ~ V1.26.1

  Kevin Wang, Director of Product Management, goes through using the MXNET API to control and configure the MXNet CBOX Direct. Current API Version: V1.26.1 Control Box Version: 2.71 && V4.21 and above Instructions and API attached

• Dante Controller for the MXnet CBOX

  An Introduction Guide to the AC-MXNET-DANTE-CBOX This article goes over the majority of features that are currently available for the AC-MXNET-DANTE-CBOX, such as configuring and monitoring devices, performing route subscriptions, and more. Note: the ...

• How to: Setup and Configure an MXnet Network Switch for AC-MXNET-1G-DANTE-EV2 and AC-MXNET-1G-DANTE-DV2 Devices.

  Overview This will be a configuration guide for configuring an MXnet network switch to work in tandem with the AC-MXNET-1G-DANTE-EV2 and AC-MXNET-1G-DANTE-DV2 devices. The new AC-MXNET-1G-DANTE-EV2/DV2 products use tagged traffic to allow for MXnet ...

• How To: Convert an AC-MXNET-CBOX-HA to a Different Software Platform

  How To: Convert an AC-MXNET-CBOX-HA to a Different Software Platform This article walks through the necessary procedures and requirements to convert a CBOX-HA to a different software platform, either for MXnet 1G, MXnet 10G, and others. Requirements: ...

• Dante Controller CBOX API ~ V1.00

  AC-MXNET-DANTE-CBOX API Published Version: V1.00 Date Published: 6/27/2025 Download Link: https://avproglobal.egnyte.com/dl/wgfnjhLP7P Requirements Dante CBOX RJ-45 cabling Personal Computer Terminal Client capable of establishing telnet/TCP sockets ...