# Video Tile

To start, put the app into Edit mode -> Add Device -> Video Tile

<figure><img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FoF09hoaaFpi2iDbRYpN5%2Fimage.png?alt=media&#x26;token=f17a4009-07c0-4b51-86c5-8fd8d662f662" alt=""><figcaption></figcaption></figure>

Enter the URL of the video stream you want to view. The app supports a few types/formats for video streaming:

* [MJPEG](https://en.wikipedia.org/wiki/Motion_JPEG)
  * Examples:

    <pre><code><strong>http://pendelcam.kip.uni-heidelberg.de/mjpg/video.mjpg
    </strong></code></pre>
* [RTSP](https://en.wikipedia.org/wiki/Real_Time_Streaming_Protocol) - the URL will start with "**rtsp**://" or "**rtsps**://" and can have an optional username and password.
  * *NOTE: I've found several links to test rtsp streams but they're not working.. if anyone has some good examples let me know*
* Youtube - a link to a Youtube video or livestream
  * Examples:

    ```
    https://www.youtube.com/live/x8OlhNaD5as?si=cuBm0is2ww3ugJ0J
    ```

<div align="left"><figure><img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FOzYyAEAQYw0ocsloOBti%2Fimage.png?alt=media&#x26;token=83b87f05-4ce7-44a5-bbf1-1a829d6d1add" alt="" width="188"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FnS7U9uP7akBvdlSu3rTp%2Fimage.png?alt=media&#x26;token=51efb307-c40f-42a1-bd07-0dbb095657aa" alt="" width="375"><figcaption><p>Reolink RLC-410W</p></figcaption></figure></div>

## Video Drivers

The app will try to pick a video driver to match the video source. But, in some cases you might want to try another driver if the video doesn't play. HD+ embeds 4 open source video libraries:

* [ExoPlayer](https://exoplayer.dev/) - this is a large open source driver which supports MANY formats
* [MJPEG](https://github.com/niqdev/ipcam-view) - this driver is specific to MJPEG video
* [RTSP](https://github.com/alexeyvasilyev/rtsp-client-android) - this driver is specific to RTSP video; I've personally found this driver faster than ExoPlayer if you have a camera that supports RTSP video
* [Youtube](https://github.com/PierfrancescoSoffritti/android-youtube-player) - this driver will play back Youtube videos

<div align="left"><figure><img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2F153QRCXwaVHbutTOfYWJ%2Fimage.png?alt=media&#x26;token=74b48963-9df3-4e3b-8088-dd86cf19c26d" alt="" width="375"><figcaption></figcaption></figure></div>

## Change Video Driver

* long-press on a video tile
* select Video Driver

<div align="left"><figure><img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FHQ8nQiyHhsFIhba83puu%2Fimage.png?alt=media&#x26;token=e9b0296f-7cfa-4ef3-8ebf-b576c9d9d8e4" alt="" width="188"><figcaption></figcaption></figure></div>

## Video Camera URL

If you have a video camera, check that it supports rtsp protocol. Many of the cloud-connected cameras today don't support this but there's several lists of those that do.

* <https://www.avertx.com/faqs/list-of-thirdparty-camera-rtsp-urls/>
* <https://help.nsoft.vision/hc/en-us/articles/4411595651345-List-of-RTSP-URLs-of-security-camera-manufacturers>
* <https://github.com/CamioCam/rtsp/blob/master/cameras/paths.csv>

## Video Support

I've only been able to test streaming video on a few different cameras.&#x20;

If you're unable to get an RTSP video working, you can try isolating the issue by using the following demo app. This apk is the latest demo app from the [rtsp library](https://github.com/alexeyvasilyev/rtsp-client-android) I'm using in HD+

* <https://jpage4500.s3.amazonaws.com/hubitat-dashboard/rtsp-client-android.apk>

If your camera stream works in this demo app but not HD+ please let me know and I'll investigate


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://joe-page-software.gitbook.io/hubitat-dashboard/tiles/video-tile.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
