From db30e60a44d4c8f361d6458a105d4e75c5a1edee Mon Sep 17 00:00:00 2001
From: Jorim Tielemans
Date: Sun, 21 Oct 2018 17:03:41 +0200
Subject: [PATCH] More various improvements (#6991)
Things starting with 'ca'
---
source/_components/calendar.google.markdown | 2 +-
source/_components/camera.amcrest.markdown | 2 +
.../camera.android_ip_webcam.markdown | 4 +-
source/_components/camera.arlo.markdown | 2 +
source/_components/camera.bloomsky.markdown | 1 -
source/_components/camera.canary.markdown | 10 ++-
source/_components/camera.dispatcher.markdown | 2 +
source/_components/camera.doorbird.markdown | 2 +
source/_components/camera.ffmpeg.markdown | 4 +-
source/_components/camera.foscam.markdown | 1 -
source/_components/camera.generic.markdown | 3 +-
source/_components/camera.local_file.markdown | 2 +
.../_components/camera.logi_circle.markdown | 2 +-
source/_components/camera.markdown | 4 +-
source/_components/camera.mjpeg.markdown | 2 +
source/_components/camera.mqtt.markdown | 30 +++----
source/_components/camera.neato.markdown | 1 -
source/_components/camera.netatmo.markdown | 4 +-
source/_components/camera.onvif.markdown | 7 +-
source/_components/camera.proxy.markdown | 80 +++++++++----------
source/_components/camera.push.markdown | 12 +--
source/_components/camera.ring.markdown | 2 +-
source/_components/camera.rpi_camera.markdown | 22 +++--
source/_components/camera.synology.markdown | 7 +-
source/_components/camera.usps.markdown | 3 +-
source/_components/camera.uvc.markdown | 1 -
source/_components/camera.verisure.markdown | 2 -
source/_components/camera.xeoma.markdown | 10 ++-
source/_components/camera.xiaomi.markdown | 7 +-
source/_components/camera.yi.markdown | 4 +-
source/_components/camera.zoneminder.markdown | 3 +-
source/_components/canary.markdown | 26 +++---
32 files changed, 137 insertions(+), 127 deletions(-)
diff --git a/source/_components/calendar.google.markdown b/source/_components/calendar.google.markdown
index ffa9233da25..f47ee421ac3 100644
--- a/source/_components/calendar.google.markdown
+++ b/source/_components/calendar.google.markdown
@@ -177,7 +177,7 @@ Trigger as soon as an event starts:
to: 'on'
```
-By using specific text in the event title, you can set conditions to initiate particular automation flows on designated events while other events will be ignored.
+By using specific text in the event title, you can set conditions to initiate particular automation flows on designated events while other events will be ignored.
For example, the actions following this condition will only be executed for events named 'vacation':
diff --git a/source/_components/camera.amcrest.markdown b/source/_components/camera.amcrest.markdown
index 73a6ca444f0..a4b5002bd7f 100644
--- a/source/_components/camera.amcrest.markdown
+++ b/source/_components/camera.amcrest.markdown
@@ -15,6 +15,8 @@ ha_release: 0.34
To get your [Amcrest](https://amcrest.com/) cameras working within Home Assistant, please follow the instructions for the general [Amcrest component](/components/amcrest).
+## {% linkable_title Configuration %}
+
Once you have enabled the [Amcrest component](/components/amcrest), add the following to your `configuration.yaml` file:
```yaml
diff --git a/source/_components/camera.android_ip_webcam.markdown b/source/_components/camera.android_ip_webcam.markdown
index 8aa3455faa8..0084fcebdb1 100644
--- a/source/_components/camera.android_ip_webcam.markdown
+++ b/source/_components/camera.android_ip_webcam.markdown
@@ -13,9 +13,10 @@ ha_release: "0.40"
ha_iot_class: "Local Polling"
---
-
The `android_ip_webcam` component adds a camera by default if you choose not to use the component but still want to see the video feed then the [`mjpeg` camera](/components/camera.mjpeg/) platform can be used.
+## {% linkable_title Configuration %}
+
To enable only the camera in your installation, add the following to your `configuration.yaml` file:
```yaml
@@ -24,4 +25,3 @@ camera:
- platform: mjpeg
mjpeg_url: http://IP_ADDRESS:8080/video
```
-
diff --git a/source/_components/camera.arlo.markdown b/source/_components/camera.arlo.markdown
index cd748d21b17..07b8fb3f726 100644
--- a/source/_components/camera.arlo.markdown
+++ b/source/_components/camera.arlo.markdown
@@ -17,6 +17,8 @@ To get your [Arlo](https://arlo.netgear.com/) cameras working within Home Assist
This component is not yet able to live stream from your Arlo camera, but it will be able to playback the last video capture.
+## {% linkable_title Configuration %}
+
Once you have enabled the [Arlo component](/components/arlo), add the following to your `configuration.yaml` file:
```yaml
diff --git a/source/_components/camera.bloomsky.markdown b/source/_components/camera.bloomsky.markdown
index 6c600b20a84..aec143513a8 100644
--- a/source/_components/camera.bloomsky.markdown
+++ b/source/_components/camera.bloomsky.markdown
@@ -13,7 +13,6 @@ ha_release: 0.13
ha_iot_class: "Local Polling"
---
-
The `bloomsky` camera component allows you to view the current photo created by the camera in the [BloomSky](https://www.bloomsky.com) weather station. This can work in concert with [BloomSky sensors](/components/sensor.bloomsky).
## {% linkable_title Configuration %}
diff --git a/source/_components/camera.canary.markdown b/source/_components/camera.canary.markdown
index 8e5f07f461f..6d46258424b 100644
--- a/source/_components/camera.canary.markdown
+++ b/source/_components/camera.canary.markdown
@@ -17,6 +17,8 @@ The `canary` camera platform allows you to watch the live stream of your [Canary
To add `canary` camera to your installation, follow instructions in [Canary component](/components/canary/). Once you have [Canary component](/components/canary/) setup, your [Canary](https://canary.is) camera(s) should show up automatically.
+## {% linkable_title Configuration %}
+
You can add the following to your `configuration.yaml` file to configure `canary` camera with optional settings:
```yaml
@@ -25,8 +27,8 @@ camera:
```
{% configuration %}
- ffmpeg_arguments:
- description: Extra options to pass to `ffmpeg`, e.g., image quality or video filter options. More details in [FFmpeg component](/components/ffmpeg).
- required: false
- type: string
+ffmpeg_arguments:
+ description: Extra options to pass to `ffmpeg`, e.g., image quality or video filter options. More details in [FFmpeg component](/components/ffmpeg).
+ required: false
+ type: string
{% endconfiguration %}
diff --git a/source/_components/camera.dispatcher.markdown b/source/_components/camera.dispatcher.markdown
index b0f3c63b851..05ceb99e2ca 100644
--- a/source/_components/camera.dispatcher.markdown
+++ b/source/_components/camera.dispatcher.markdown
@@ -19,6 +19,8 @@ This platform is meant for developers only.
The `dispatcher` camera platform allows developers to create virtual camera's.
+## {% linkable_title Configuration %}
+
You would normally not add this camera to your configuration directly but have it be discovered by one of the components that uses it.
```yaml
diff --git a/source/_components/camera.doorbird.markdown b/source/_components/camera.doorbird.markdown
index ce23d946725..4c0734e2695 100644
--- a/source/_components/camera.doorbird.markdown
+++ b/source/_components/camera.doorbird.markdown
@@ -19,6 +19,8 @@ The `doorbird` implementation allows you to view the live video and previous ima
You must have the [DoorBird component](/components/doorbird/) configured to use this camera.
+## {% linkable_title Configuration %}
+
To enable the camera, add the following to your `configuration.yaml` file:
```yaml
diff --git a/source/_components/camera.ffmpeg.markdown b/source/_components/camera.ffmpeg.markdown
index e87ea211844..86f1c261f05 100644
--- a/source/_components/camera.ffmpeg.markdown
+++ b/source/_components/camera.ffmpeg.markdown
@@ -13,9 +13,10 @@ ha_release: 0.26
ha_iot_class: "Local Polling"
---
-
The `ffmpeg` platform allows you to use any video feed as a camera in Home Assistant via [FFmpeg](http://www.ffmpeg.org/). This video source must support multiple simultaneous reads, because for every concurrent Home Assistant user, a connection will be made to the source every 10 seconds. Normally this should not be a problem.
+## {% linkable_title Configuration %}
+
To enable your FFmpeg feed in your installation, add the following to your `configuration.yaml` file:
```yaml
@@ -44,5 +45,4 @@ extra_arguments:
You can control the image quality with [`extra_arguments`](https://www.ffmpeg.org/ffmpeg-codecs.html#jpeg2000) `-q:v 2-32` or with lossless option `-pred 1`.
-
If you are running into trouble with this sensor, please refer to the [Troubleshooting section](/components/ffmpeg/#troubleshooting).
diff --git a/source/_components/camera.foscam.markdown b/source/_components/camera.foscam.markdown
index 8215b0f2ffb..3a0cbb53fae 100644
--- a/source/_components/camera.foscam.markdown
+++ b/source/_components/camera.foscam.markdown
@@ -12,7 +12,6 @@ ha_category: Camera
ha_iot_class: "Local Polling"
---
-
The `foscam` platform allows you to watch the live stream of your [Foscam](http://www.foscam.com/) IP camera in Home Assistant.
## {% linkable_title Configuration %}
diff --git a/source/_components/camera.generic.markdown b/source/_components/camera.generic.markdown
index a5c9d503d68..49349dc4605 100644
--- a/source/_components/camera.generic.markdown
+++ b/source/_components/camera.generic.markdown
@@ -13,11 +13,12 @@ ha_release: pre 0.7
ha_iot_class: "depends"
---
-
The `generic` camera platform allows you to integrate any IP camera or other URL into Home Assistant. Templates can be used to generate the URLs on the fly.
Home Assistant will serve the images via its server, making it possible to view your IP cameras while outside of your network. The endpoint is `/api/camera_proxy/camera.[name]`.
+## {% linkable_title Configuration %}
+
To enable this camera in your installation, add the following to your `configuration.yaml` file:
```yaml
diff --git a/source/_components/camera.local_file.markdown b/source/_components/camera.local_file.markdown
index cb870409c10..c94de28a5b7 100644
--- a/source/_components/camera.local_file.markdown
+++ b/source/_components/camera.local_file.markdown
@@ -17,6 +17,8 @@ The `local_file` camera platform allows you to integrate an image file from disk
The `local_file` camera can for example be used with various camera platforms that save a temporary images locally. It can also be used to display a graph that you render periodically and will then be displayed in Home Assistant.
+## {% linkable_title Configuration %}
+
To enable this camera in your installation, add the following to your `configuration.yaml` file:
```yaml
diff --git a/source/_components/camera.logi_circle.markdown b/source/_components/camera.logi_circle.markdown
index beed202eafa..20a742ffaef 100644
--- a/source/_components/camera.logi_circle.markdown
+++ b/source/_components/camera.logi_circle.markdown
@@ -35,8 +35,8 @@ camera:
scan_interval:
description: How frequently to query for new camera stills, value are in seconds.
required: false
- default: 60
type: integer
+ default: 60
{% endconfiguration %}
### {% linkable_title Service `camera.logi_circle_livestream_record` %}
diff --git a/source/_components/camera.markdown b/source/_components/camera.markdown
index 499481eb098..0231195e04c 100644
--- a/source/_components/camera.markdown
+++ b/source/_components/camera.markdown
@@ -9,10 +9,9 @@ sharing: true
footer: true
---
-
The camera component allows you to use IP cameras with Home Assistant. With a little additional work you could use [USB cameras](/blog/2016/06/23/usb-webcams-and-home-assistant/) as well.
-### {% linkable_title Service %}
+### {% linkable_title Services %}
Once loaded, the `camera` platform will expose services that can be called to perform various actions.
@@ -82,4 +81,3 @@ A simple way to test if you have set up your `camera` platform correctly, is to
"entity_id": "camera.living_room_camera"
}
```
-
diff --git a/source/_components/camera.mjpeg.markdown b/source/_components/camera.mjpeg.markdown
index f87595dfc6b..d4195ca7b54 100644
--- a/source/_components/camera.mjpeg.markdown
+++ b/source/_components/camera.mjpeg.markdown
@@ -16,6 +16,8 @@ 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.
+## {% linkable_title Configuration %}
+
To enable this camera in your installation,
add the following to your `configuration.yaml` file:
diff --git a/source/_components/camera.mqtt.markdown b/source/_components/camera.mqtt.markdown
index c7db3ae4ac2..177e89f8924 100644
--- a/source/_components/camera.mqtt.markdown
+++ b/source/_components/camera.mqtt.markdown
@@ -17,6 +17,8 @@ The `mqtt` camera platform allows you to integrate the content of an image file
This can be used with an application or a service capable of sending images through MQTT, for example [Zanzito](https://play.google.com/store/apps/details?id=it.barbaro.zanzito).
+## {% linkable_title Configuration %}
+
To enable this camera in your installation, add the following to your `configuration.yaml` file:
```yaml
@@ -27,18 +29,18 @@ camera:
```
{% configuration %}
- topic:
- description: MQTT topic to subscribe to.
- required: true
- type: string
- name:
- description: Name of the camera.
- required: false
- type: string
- unique_id:
- description: >
- An ID that uniquely identifies this camera. If two cameras have the same unique ID
- Home Assistant will raise an exception.
- required: false
- type: string
+topic:
+ description: MQTT topic to subscribe to.
+ required: true
+ type: string
+name:
+ description: Name of the camera.
+ required: false
+ type: string
+unique_id:
+ description: >
+ An ID that uniquely identifies this camera. If two cameras
+ have the same unique ID Home Assistant will raise an exception.
+ required: false
+ type: string
{% endconfiguration %}
diff --git a/source/_components/camera.neato.markdown b/source/_components/camera.neato.markdown
index 3b959c0bc38..4027e94fd24 100644
--- a/source/_components/camera.neato.markdown
+++ b/source/_components/camera.neato.markdown
@@ -13,7 +13,6 @@ ha_release: 0.42
ha_iot_class: "Cloud Polling"
---
-
The `neato` camera platform allows you to view the latest cleaning map of your [Neato Botvac Connected](https://www.neatorobotics.com/robot-vacuum/botvac-connected-series/botvac-connected/).
To add `neato` camera to your installation, follow instructions in [Neato component](/components/neato/).
diff --git a/source/_components/camera.netatmo.markdown b/source/_components/camera.netatmo.markdown
index eb11c1a1a49..bc38d19196a 100644
--- a/source/_components/camera.netatmo.markdown
+++ b/source/_components/camera.netatmo.markdown
@@ -13,10 +13,10 @@ ha_release: 0.22
ha_iot_class: "Local Polling"
---
-### {% linkable_title Basic Configuration %}
-
The `netatmo` camera platform is consuming the information provided by a [Netatmo](https://www.netatmo.com) camera. This component allows you to view the current photo created by the Camera.
+### {% linkable_title Basic configuration %}
+
To enable the Netatmo camera, you have to set up [netatmo](/components/netatmo/), this will use discovery to add your camera.
### {% linkable_title Advanced configuration %}
diff --git a/source/_components/camera.onvif.markdown b/source/_components/camera.onvif.markdown
index 6d34a37788c..3a695d30fe6 100644
--- a/source/_components/camera.onvif.markdown
+++ b/source/_components/camera.onvif.markdown
@@ -12,9 +12,10 @@ ha_category: Camera
ha_release: 0.47
---
-
The `onvif` camera platform allows you to use an ONVIF camera in Home Assistant. This requires the [`ffmpeg` component](/components/ffmpeg/) to be already configured.
+## {% linkable_title Configuration %}
+
To enable your ONVIF camera in your installation, add the following to your `configuration.yaml` file:
```yaml
@@ -44,13 +45,13 @@ password:
port:
description: The port for the camera.
required: false
- default: 5000
type: integer
+ default: 5000
profile:
description: Video profile that will be used to obtain the stream, more details below.
required: false
- default: 0
type: integer
+ default: 0
extra_arguments:
description: "Extra options to pass to `ffmpeg`, e.g., image quality or video filter options. More details in [FFmpeg component](/components/ffmpeg)."
required: false
diff --git a/source/_components/camera.proxy.markdown b/source/_components/camera.proxy.markdown
index e8a38d4b23f..d1c92138edf 100644
--- a/source/_components/camera.proxy.markdown
+++ b/source/_components/camera.proxy.markdown
@@ -11,13 +11,14 @@ ha_category: Camera
ha_release: 0.65
---
-
The `proxy` camera platform allows you to pass another camera's output through post-processing routines and generate a new camera with the post-processed output.
The current post-processing supports resizing the image/MJPEG as well as limiting the maximum refresh rate.
The current proxy capabilities are intended to reduce the camera bandwidth for slower internet connections.
+## {% linkable_title Configuration %}
+
To enable this camera in your installation, you must first have an existing working camera configured in Home Assistant. Next, add the following to your `configuration.yaml` file:
```yaml
@@ -30,47 +31,46 @@ camera:
```
{% configuration %}
- entity_id:
- description: The ID of another Home Assistant camera to post-process.
- required: true
- type: string
- name:
- description: This parameter allows you to override the name of your camera.
- required: false
- type: string
- max_image_width:
- description: The maximum width of single images taken from the camera (aspect ratio will be maintained).
- required: false
- type: integer
- max_stream_width:
- description: The maximum width of the MJPEG stream from the camera (aspect ratio will be maintained).
- required: false
- type: integer
- image_quality:
- description: The quality level used for resulting JPEG for snapshots.
- required: false
- type: integer
- default: 75
- stream_quality:
- description: The quality level used for resulting MJPEG streams.
- required: false
- type: integer
- default: 75
- image_refresh_rate:
- description: The minimum time in seconds between generating successive image snapshots.
- required: false
- type: float
- force_resize:
- description: Resize the image even if the resulting image would take up more bandwidth than the original.
- required: false
- type: boolean
- cache_images:
- description: Preserve the last image and re-send in the case the camera is not responding.
- required: false
- type: boolean
+entity_id:
+ description: The ID of another Home Assistant camera to post-process.
+ required: true
+ type: string
+name:
+ description: This parameter allows you to override the name of your camera.
+ required: false
+ type: string
+max_image_width:
+ description: The maximum width of single images taken from the camera (aspect ratio will be maintained).
+ required: false
+ type: integer
+max_stream_width:
+ description: The maximum width of the MJPEG stream from the camera (aspect ratio will be maintained).
+ required: false
+ type: integer
+image_quality:
+ description: The quality level used for resulting JPEG for snapshots.
+ required: false
+ type: integer
+ default: 75
+stream_quality:
+ description: The quality level used for resulting MJPEG streams.
+ required: false
+ type: integer
+ default: 75
+image_refresh_rate:
+ description: The minimum time in seconds between generating successive image snapshots.
+ required: false
+ type: float
+force_resize:
+ description: Resize the image even if the resulting image would take up more bandwidth than the original.
+ required: false
+ type: boolean
+cache_images:
+ description: Preserve the last image and re-send in the case the camera is not responding.
+ required: false
+ type: boolean
{% endconfiguration %}
-
## {% linkable_title Examples %}
Example of using a Camera proxy along with a Foscam camera:
diff --git a/source/_components/camera.push.markdown b/source/_components/camera.push.markdown
index be639978032..9794c37fbc7 100644
--- a/source/_components/camera.push.markdown
+++ b/source/_components/camera.push.markdown
@@ -19,7 +19,7 @@ Optionally the Push Camera can **buffer** a given number of images, creating an
Images are cleared on new events, and events are separated by a soft (configurable) **timeout**.
-## Integration with motionEye
+## {% linkable_title Integration with motionEye %}
The `push` camera can as an example be used with [motionEye](https://github.com/ccrisan/motioneye/wiki) a web frontend for the motion daemon. motionEye is usually configured to save/record files ***only*** when motion is detected. It provides a hook to run a command whenever an image is saved, which can be used together with cURL to send the motion detected images to the `push` camera, as shown in this example:
@@ -57,25 +57,25 @@ camera:
name:
description: The name you would like to give to the camera.
required: false
- default: Push Camera
type: string
+ default: Push Camera
buffer:
description: Number of images to buffer per event. Be conservative, large buffers will starve your system memory.
required: false
- default: 1
type: string
+ default: 1
timeout:
description: Amount of time after which the event is considered to have finished.
required: false
- default: 5 seconds
type: time
+ default: 5 seconds
token:
description: User provided token acting as access control, should be a large string (more then 8 chars). Required if you can't use HA new auth system (0.77).
- required: false
+ required: false
type: string
field:
description: HTTP POST field containing the image file
required: false
- default: image
type: string
+ default: image
{% endconfiguration %}
diff --git a/source/_components/camera.ring.markdown b/source/_components/camera.ring.markdown
index 98d03ff0e65..9236be6f4fb 100644
--- a/source/_components/camera.ring.markdown
+++ b/source/_components/camera.ring.markdown
@@ -33,8 +33,8 @@ ffmpeg_arguments:
scan_interval:
description: How frequently to query for new video in seconds.
required: false
- default: 90
type: integer
+ default: 90
{% endconfiguration %}
**Note:** To be able to playback the last capture, it is required to install the `ffmpeg` component. Make sure to follow the steps mentioned at [FFMPEG](/components/ffmpeg/) documentation.
diff --git a/source/_components/camera.rpi_camera.markdown b/source/_components/camera.rpi_camera.markdown
index 0cc4eaa01c0..f7148f19775 100644
--- a/source/_components/camera.rpi_camera.markdown
+++ b/source/_components/camera.rpi_camera.markdown
@@ -13,7 +13,6 @@ ha_iot_class: "Local Polling"
ha_release: 0.17
---
-
The `rpi_camera` platform allows you to integrate the Raspberry Pi camera into Home Assistant. This component uses the application [`raspistill`](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) to store the image from camera.
## {% linkable_title Configuration %}
@@ -30,49 +29,48 @@ camera:
image_width:
description: Set the image width.
required: false
- default: 640
type: integer
+ default: 640
name:
description: Name of the camera.
required: false
- default: Raspberry Pi Camera
type: string
+ default: Raspberry Pi Camera
image_height:
description: Set the image height.
required: false
- default: 480
type: integer
+ default: 480
image_quality:
description: Set the image quality (from 0 to 100).
required: false
- default: 7
type: integer
+ default: 7
image_rotation:
description: Set image rotation (0-359).
required: false
- default: 0
type: integer
+ default: 0
horizontal_flip:
description: Set horizontal flip (0 to disable, 1 to enable).
required: false
- default: 0
type: integer
+ default: 0
vertical_flip:
description: Set vertical flip (0 to disable, 1 to enable).
required: false
- default: 0
type: integer
+ default: 0
timelapse:
description: Takes a picture every this many milliseconds (thousands of a second) - the default means one picture a second.
required: false
- default: 1000
type: integer
+ default: 1000
file_path:
description: Save the picture in a custom file path.
required: false
- default: A temporary file is used.
type: string
+ default: A temporary file is used.
{% endconfiguration %}
-
-The given **file_path** must be an existing file because the camera platform setup performs a writeable check on it. Also, keep in mind that the path should be [whitelisted](/docs/configuration/basic/).
+The given **file_path** must be an existing file because the camera platform setup performs a writeable check on it. Also, keep in mind that the path should be [whitelisted](/docs/configuration/basic/).
diff --git a/source/_components/camera.synology.markdown b/source/_components/camera.synology.markdown
index 78010327625..2e0e232a0cb 100644
--- a/source/_components/camera.synology.markdown
+++ b/source/_components/camera.synology.markdown
@@ -13,7 +13,6 @@ ha_release: 0.31
ha_iot_class: "Local Polling"
---
-
The `synology` camera platform allows you to watch the live streams of your [Synology](https://www.synology.com/) Surveillance Station based IP cameras in Home Assistant.
## {% linkable_title Configuration %}
@@ -33,8 +32,8 @@ camera:
name:
description: A name for this Synology camera.
required: false
- default: Synology Camera
type: string
+ default: Synology Camera
url:
description: The URL to your Synology, including port.
required: true
@@ -50,8 +49,8 @@ password:
timeout:
description: The timeout in seconds used when connecting to the Surveillance Station.
required: false
- default: 5
type: integer
+ default: 5
whitelist:
description: A list of which cameras you want to add, the names must be the same as in Surveillance Station. If omitted all cameras are added.
required: false
@@ -59,8 +58,8 @@ whitelist:
verify_ssl:
description: Verify SSL/TLS certificate for HTTPS request.
required: false
- default: true
type: boolean
+ default: true
{% endconfiguration %}
## {% linkable_title Full example %}
diff --git a/source/_components/camera.usps.markdown b/source/_components/camera.usps.markdown
index 5ed58ee5624..e589a349a57 100644
--- a/source/_components/camera.usps.markdown
+++ b/source/_components/camera.usps.markdown
@@ -13,13 +13,14 @@ ha_release: 0.52
ha_iot_class: "Cloud Polling"
---
-
The `usps` camera component allows you to view the mail piece images made available through USPS via the Informed Delivery service. You must "Opt-In" to [Informed Delivery](https://informeddelivery.usps.com/box/pages/intro/start.action) to see mail images. This works in concert with [USPS sensors](/components/sensor.usps).
You must have the [USPS component](/components/usps/) configured to use this camera. The camera will be setup if the `usps` component is configured and the required configuration is set.
+## {% linkable_title Configuration %}
+
To customize the interval that mail images are rotated in the mail camera you can edit your `configuration.yaml` file with the following settings:
```yaml
# Example configuration.yaml entry
diff --git a/source/_components/camera.uvc.markdown b/source/_components/camera.uvc.markdown
index d83f1457e87..cd86a1214cf 100644
--- a/source/_components/camera.uvc.markdown
+++ b/source/_components/camera.uvc.markdown
@@ -56,4 +56,3 @@ password:
type: string
default: ubnt
{% endconfiguration %}
-
diff --git a/source/_components/camera.verisure.markdown b/source/_components/camera.verisure.markdown
index 35b4c25e4e7..e3980f71748 100644
--- a/source/_components/camera.verisure.markdown
+++ b/source/_components/camera.verisure.markdown
@@ -13,8 +13,6 @@ ha_release: 0.31
ha_iot_class: "Local Polling"
---
-
The `verisure` camera platform allows you to control your [Verisure](https://www.verisure.com/) cameras.
The requirement is that you have setup your [Verisure hub](/components/verisure/).
-
diff --git a/source/_components/camera.xeoma.markdown b/source/_components/camera.xeoma.markdown
index e54e24f3b37..afb89f1877d 100644
--- a/source/_components/camera.xeoma.markdown
+++ b/source/_components/camera.xeoma.markdown
@@ -15,6 +15,8 @@ ha_release: 0.62
The `Xeoma` camera platform allows you to view the video feeds from a [Xeoma](http://felenasoft.com/xeoma) video surveillance server.
+## {% linkable_title Configuration %}
+
To enable Xeoma camera feeds, add the following lines to your `configuration.yaml`:
```yaml
@@ -40,8 +42,8 @@ password:
new_version:
description: Set to false if the Xeoma server version is 17.5 or earlier.
required: false
- default: true
type: boolean
+ default: true
cameras:
description: List of customizations for individual Xeoma cameras.
required: false
@@ -54,16 +56,16 @@ cameras:
name:
description: The name to display in the frontend for this camera.
required: false
- default: The `image_name` for this camera.
type: string
+ default: The `image_name` for this camera.
hide:
description: Don't show this camera in Home Assistant.
required: false
- default: false
type: boolean
+ default: false
{% endconfiguration %}
-## {% linkable_title Full examples %}
+## {% linkable_title Full example %}
```yaml
# Example configuration.yaml entry
diff --git a/source/_components/camera.xiaomi.markdown b/source/_components/camera.xiaomi.markdown
index 05e213825de..0dc5777f35a 100644
--- a/source/_components/camera.xiaomi.markdown
+++ b/source/_components/camera.xiaomi.markdown
@@ -76,16 +76,15 @@ password:
path:
description: The path to the raw MP4 files.
required: false
- default: /media/mmcblk0p1/record
type: string
+ default: /media/mmcblk0p1/record
username:
description: The user that can access the FTP server.
required: false
- default: root
type: string
+ default: root
ffmpeg_arguments:
- description: >
- Extra options to pass to `ffmpeg`
+ description: Extra options to pass to `ffmpeg`.
required: false
type: string
{% endconfiguration %}
diff --git a/source/_components/camera.yi.markdown b/source/_components/camera.yi.markdown
index dada5b76b48..0fce50e8b96 100644
--- a/source/_components/camera.yi.markdown
+++ b/source/_components/camera.yi.markdown
@@ -81,13 +81,13 @@ password:
path:
description: The path to the raw MP4 files.
required: false
- default: /media/mmcblk0p1/record
type: string
+ default: /media/mmcblk0p1/record
username:
description: The user that can access the FTP server.
required: false
- default: root
type: string
+ default: root
ffmpeg_arguments:
description: Extra options to pass to `ffmpeg` (e.g., image quality or video filter options).
required: false
diff --git a/source/_components/camera.zoneminder.markdown b/source/_components/camera.zoneminder.markdown
index d1fc230ecc4..51a00ef3d17 100644
--- a/source/_components/camera.zoneminder.markdown
+++ b/source/_components/camera.zoneminder.markdown
@@ -13,13 +13,14 @@ ha_release: 0.39
ha_iot_class: "Local Polling"
---
-
The `zoneminder` camera platform lets you monitor the current stream of your [ZoneMinder](https://www.zoneminder.com) cameras.
You must have the [ZoneMinder component](/components/zoneminder/) configured to view the camera stream.
+## {% linkable_title Configuration %}
+
To set it up, add the following information to your `configuration.yaml` file:
```yaml
diff --git a/source/_components/canary.markdown b/source/_components/canary.markdown
index d9805b5edff..8f43c61d53b 100644
--- a/source/_components/canary.markdown
+++ b/source/_components/canary.markdown
@@ -29,19 +29,19 @@ canary:
```
{% configuration %}
- username:
- description: The username for accessing your Canary account.
- required: true
- type: string
- password:
- description: The password for accessing your Canary account.
- required: true
- type: string
- timeout:
- description: Timeout to wait for connections.
- required: false
- type: integer
- default: 10
+username:
+ description: The username for accessing your Canary account.
+ required: true
+ type: string
+password:
+ description: The password for accessing your Canary account.
+ required: true
+ type: string
+timeout:
+ description: Timeout to wait for connections.
+ required: false
+ type: integer
+ default: 10
{% endconfiguration %}
Once loaded, your front end will have the following components: