Custom card for Home Assistant's UI LoveLace which will display images and videos in the style of a gallery.
This was developed for use alongside the component for Kuna cameras but should work with any images/videos, in theory.
New in v2.0 - support for selecting Camera entities in addition to the Files Component entities.
To display files from a folder, this card requires the files component to be installed/configured.
Now available in HACS, but follow the below to install manually. For more details, see Thomas Loven's Install Guide
- Place the
gallary-card.js
file under your/config/www/
folder of Home Assistant (suggest - create a subdirectory forcards
) - Add the card within the resources section (Config -> Lovelace Dashboards -> Resources) URL: /local/cards/gallery-card.js Type: Javascript Module
- Add the gallery card to your Lovelace configuration. Use of the viual editor is preferred, but the below example is if using the code editor:
type: 'custom:gallery-card' entities: - camera.front_door - sensor.gallery_images menu_alignment: Responsive maximum_files: 10 file_name_format: '%YYY_%m_%d_%H_%M_%S' caption_format: '%m/%d %H:%M %p'
I recommend adding the card to a view set to Panel Mode for best results.
Whether using the editor or yaml, the following configurations can be used:
Name | Type | Default | Description |
---|---|---|---|
entities | string | Required | A list of entity_id of the files sensor added above or of camera entities. |
title | string | Optional | The name to show at the top of the card. |
menu_alignment | string | Optional | Alignment of the menu (the small list of images/videos to view). Default is if not specified is Responsive (see below) |
maximum_files | integer | Optional | The number of files to show from each entity in the gallery list. You may want to limit videos to make it perform better and to conserve bandwith. Used in combination with sort (using the config as above, the latest 10 for each entity by date will be shown) |
file_name_format | string | Optional | The format of the file names (see below). Used in combination with caption_format for the captions below the image/video. |
caption_format | string | Optional | The format of the caption (see below). Used in combination with file_name_format. |
Available options for Menu Alignment are below:
Value | Description |
---|---|
Responsive | On wider views (e.g. landscape >= 600px) uses the Right alignment, on narrower views (e.g. portrait < 600px) the Bottom |
Left | Always shows a vertical list on the left of the card. |
Right | Always shows a vertical list on the right of the card (shown in the image above). |
Top | Always shows a horizontal list on the top of the card. |
Botom | Always shows a vertical list on the bottom of the card. |
Hidden | Hides the list and only shows the larger image |
The captions under the image/video is formatted using file_name_format and caption_format. If either is ommitted, the raw filename is used.
The assumption is that the file name contains the date formatted such that it can be parsed and formatted for easier human consumption.
Use the following placeholders for the date components:
Placeholder | Description |
---|---|
%YYY | A 4 digit year, e.g. 2019 |
%m | The 2 digit month |
%d | The 2 digit day |
%H | The 2 digit hour |
%M | The 2 digit minute |
%S | The 2 digit seconds |
%p | 2 digits AM or PM (if included in caption_format, the output will be converted to 12 hour, if not the value will remain as the %H placeholder) |
Example:
- file_name_format: "%YYY_%m_%d__%H_%M_%S-0400"
- Assumes the file name is in the format 2019_06_19__20_00_00-0400
- caption_format: "%m/%d %H:%M %p"
- Will parse the file name and return a date formatted as 06/19 08:00 PM
The files component largely taken from work done by @zsarnett in the slideshow card, from which other inspiration was also taken.