mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-03 01:28:58 +00:00
1aca7b08cf
* e.g. to e.g., and proper case for Home Assistant * Instructions how to -> Instructions on how to
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
---
|
|
layout: page
|
|
title: "Generic MJPEG IP Camera"
|
|
description: "Instructions on how to integrate IP cameras within Home Assistant."
|
|
date: 2015-11-09 08:36
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: camcorder.png
|
|
ha_category: Camera
|
|
ha_release: pre 0.7
|
|
ha_iot_class: "depends"
|
|
---
|
|
|
|
|
|
The `mjpeg` camera platform allows you to integrate IP cameras which are capable to stream their video with MJPEG into Home Assistant.
|
|
|
|
To enable this camera in your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
camera:
|
|
- platform: mjpeg
|
|
mjpeg_url: http://192.168.1.92/mjpeg
|
|
```
|
|
|
|
Configuration variables:
|
|
|
|
- **mjpeg_url** (*Required*): The URL your camera serves the video on, eg. http://192.168.1.21:2112/
|
|
- **still_image_url** (*Optional*): The URL for thumbnail picture if camera support that.
|
|
- **name** (*Optional*): This parameter allows you to override the name of your camera.
|
|
- **username** (*Optional*): The username for accessing your camera.
|
|
- **password** (*Optional*): The password for accessing your camera.
|
|
- **authentication** (*Optional*): `basic` (default) or `digest` auth for requests.
|
|
|
|
<p class='note'>
|
|
There is a <a href="https://github.com/shazow/urllib3/issues/800" target="_blank">known issue in urllib3</a> that you will get error messages in your logs like <code>[StartBoundaryNotFoundDefect(), MultipartInvariantViolationDefect()], unparsed data: ''</code> but the component still works fine. You can ignore the messages.
|
|
</p>
|
|
|
|
## {% linkable_title Examples %}
|
|
|
|
Example of using a DCS-930L Wireless N Network Camera from D-Link:
|
|
|
|
```yaml
|
|
camera:
|
|
- platform: mjpeg
|
|
name: Livingroom Camera
|
|
still_image_url: http://IP/image.jpg
|
|
mjpeg_url: http://IP/video/mjpg.cgi
|
|
```
|