Skip to content

Latest commit

 

History

History
47 lines (36 loc) · 2.27 KB

camera.md

File metadata and controls

47 lines (36 loc) · 2.27 KB

Camera

Card type custom:houseview-camera-card, or type: camera in the cards list of custom:houseview-card. Available since 1.0.

Shows a still picture from a camera.* entity. The widget loads the entity's entity_picture and asks for a fresh snapshot every 30 seconds, so the picture never goes stale and the camera is not polled harder than that. Only pictures from your own Home Assistant (the page origin, or the hassUrl origin) and under /camera_proxy/ are loaded; anything else leaves the widget showing "Snapshot unavailable".

A long press opens the more-info dialog. When the card config has a camera_gallery, a tap opens the camera grid instead, and the widget stays usable while its own camera is offline.

Option Type Default Description
entity entity required A camera.* entity
name string friendly name Label
size normal/wide/tall/large normal Widget size on carousel pages

Camera grid (camera_gallery)

A card-level option (next to cards, not inside a widget) that adds a full-screen grid of up to four cameras. It also works on a standalone camera card.

Key Type Default Description
entity entity required A camera.* entity. One to four entries
name string friendly name Label shown on the camera
slot 0-3 list position Grid cell: 0 top left, 1 top right, 2 bottom left, 3 bottom right
stream boolean false Use Home Assistant's MJPEG stream (/camera_proxy_stream/) instead of a snapshot every 5 s

Tap a camera to enlarge it; Back (or the Escape key) steps back, first to the grid, then closes it. Pictures refresh every 5 seconds while the grid is open, a camera that does not answer for 20 seconds reads "Camera not responding", and a stream that failed is retried after 30 seconds. The grid is an aria-modal dialog and page swiping is disabled while it is open. An invalid list fails with Camera view needs one to four camera entities.

type: custom:houseview-camera-card
entity: camera.front_door
camera_gallery:
  - entity: camera.front_door
    name: Front door
  - entity: camera.garden
    stream: true