# Streaming

Source: https://help.zira.us/docs/dashboards/streaming-widget
Summary: Use the Streaming widget to show live video from an AI Vision Device inside a dashboard.
Updated: 2026-08-20

Use **Streaming** when the dashboard should include live visual context from an **AI Vision Device**.

This widget is useful when people need to watch the live situation while also reviewing charts, KPIs, or routing information on the same page.

## Navigation

Open a dashboard, enter edit mode if needed, then choose **Add widget**.

Use **Streaming** when the dashboard should include a live video area.

## When to use it

The Streaming widget appears directly on the dashboard as a live video tile.

It works best when it has enough space to stay readable.

## Add the widget

1. Open a dashboard.
2. Click **Add widget**.
3. Choose **Streaming**.

## Configure the stream

When the widget opens:

1. Enter the widget name.
2. Select the **AI Vision Device**.
3. Choose the video rotation if needed.
4. Turn on the snapshot file name if you want it, and choose where it sits on the video.
5. Review the preview.
6. Save the widget.

## Show the snapshot file name

While the stream runs, the device saves an image for each frame it inspects and reports the file
name it used. The widget can show that name on top of the video.

This is **off unless you turn it on**, because the label covers a small part of the image. Switch
on **Show snapshot file name** when editing the widget.

This helps when someone needs to:

- match what they are watching to the stored image
- quote an exact file name when reporting a problem
- confirm the device is still saving images

The coloured dot beside the name shows whether the image has finished uploading:

- **green** — the image is saved and can be opened
- **amber** — the device has captured it but the upload is still in progress

Use **File Name Position** to move the label to any corner of the video. **Bottom left** is the
default, so the label stays clear of the player controls.

The device reports its most recent images, newest first. Click the arrow on the label to see the
others, and hover any of them for the full file name and the time it was captured.

Notes:

- The label only appears while live view is running, and clears when the stream stops.
- If the device is not reporting file names, no label appears.

## When to use Streaming

Use **Streaming** when:

- users need a live video view on the dashboard
- a visual check should sit beside charts, KPIs, or routing information
- the dashboard is used for active monitoring instead of historical review only

## Tips

- Use this widget only when the related AI Vision Device is available.
- Keep the widget large enough to remain useful.
- Place it near the widgets that describe the same device or process.