Skip to content

Update generic with no still_image_url option #20862

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
frenck merged 3 commits into from
Jan 2, 2022
Merged

Update generic with no still_image_url option #20862

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3f82fb7
Update generic with no still_image_url option
uvjustin Dec 26, 2021
7d6cacd
Mark still_image_url and stream_source as Optional
uvjustin Dec 26, 2021
b8b472e
Uppercase URL
uvjustin Dec 26, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 18 additions & 6 deletions source/_integrations/generic.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,23 +28,23 @@ camera:

{% configuration %}
still_image_url:
description: "The URL your camera serves the image on, e.g., `http://192.168.1.21:2112/`. Can be a [template](/topics/templating/)."
required: true
description: "The URL your camera serves the image on, e.g., `http://192.168.1.21:2112/`. Can be a [template](/topics/templating/). At least one of still_image_url or stream_source must be provided."
required: false
type: string
stream_source:
description: "The URL your camera serves the live stream on, e.g., `rtsp://192.168.1.21:554/`. Can be a [template](/topics/templating/)."
description: "The URL your camera serves the live stream on, e.g., `rtsp://user:pass@192.168.1.21:554/`. Can be a [template](/topics/templating/). Usernames and passwords must be embedded in the URL. At least one of still_image_url or stream_source must be provided."
required: false
type: string
name:
description: This parameter allows you to override the name of your camera.
required: false
type: string
username:
description: The username for accessing your camera.
description: The username for accessing your camera. Note that this username applies only to still_image_url and not to stream_source.
required: false
type: string
password:
description: The password for accessing your camera.
description: The password for accessing your camera. Note that this password applies only to still_image_url and not to stream_source.
required: false
type: string
authentication:
Expand Down Expand Up @@ -120,6 +120,7 @@ camera:
name: Host instance camera feed
still_image_url: https://127.0.0.5:8123/api/camera_proxy/camera.live_view
```

### Image from HTTP only camera

To access a camera which is only available via HTTP, you must turn off SSL verification.
Expand All @@ -141,7 +142,18 @@ camera:
- platform: generic
name: Streaming Enabled
still_image_url: http://194.218.96.92/jpg/image.jpg
stream_source: rtsp://194.218.96.92:554
username: user
password: pass
stream_source: rtsp://user:pass@194.218.96.92:554
```

If a camera only has a live stream URL and no snapshot URL, the [stream](/integrations/stream/) component can also generate still images from the live stream URL.

```yaml
camera:
- platform: generic
name: Streaming
stream_source: rtsp://user:pass@194.218.96.92:554
```

### Secured access to the camera
Expand Down