> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Video Player

> Play a video on the dashboard.

<Info>
  **Category:** Display · **Plays:** video · **Sends commands:** no
</Info>

## Mental model

A **Video Player is a video player.** Point it at a video and it plays — for
tutorials, product clips, or recorded footage.

## When to use it

* Embedded tutorial / product video
* Recorded playback (vs. live — use [WebRTC Viewer](/dashboard/widgets/webrtc-viewer))

## Settings

### General / Style

* **Video source** · **poster image URL**
* **Autoplay** · **loop** · **muted** · **playback speed**
* **Width / height** · **alignment** · **padding**

## Script API example

The same interactions from a [dashboard script](/script/overview):

```js theme={null}
// Resize for portrait phones
if (context.device.orientation === 'portrait') widget.resize('promoVideo', 320, 180);
```

<Card title="WebRTC Viewer" icon="video" href="/dashboard/widgets/webrtc-viewer">
  For live streams instead of recorded video.
</Card>