Home

Awesome

Shutter card

hacs_badge buymeacoffee_badge

Note : Be careful, since version 2021.11.0 of Home Assistant, there is a breaking change in the icon buttons. So install v1.3.0 of this card only if you have at least the version 2021.11.0 of Home Assistant

This card allows to open, close or set a shutter to the opening rate you want.

Shutter card

Configuration

General

NameTypeRequiredDefaultDescription
typestringTrue-Must be "custom:shutter-card"
titlestringFalse-Title of the card

Entities

NameTypeRequiredDefaultDescription
entitystringTrue-The shutter entity ID
namestringFalseFriendly name of the entityName to display for the shutter
buttons_positionstringFalseleftSet buttons on left, right, top or bottom of the shutter
title_positionstringFalsetopSet title on top or on bottom of the shutter
invert_percentagebooleanFalsefalseSet it to true if your shutter is 100% when it is closed, and 0% when it is opened
can_tiltbooleanFalsefalseSet it to true if your shutters support tilting.
partial_close_percentageintFalse0Set it to a percentage (0-100) if you want to be able to quickly go to this "partially closed" state using a button.
offset_closed_percentageintFalse0Set it to a percentage (0-100) of travel that will still be considered a "closed" state in the visualization.
always_percentagebooleanFalsefalseIf set to true, the end states (opened/closed) will be also as numbers (0 / 100 % ) instead of a text
shutter_width_pxintFalse153Set shutter visualization width in px. You can make it thicker or narrower to fit your layout.
disable_end_buttonsbooleanFalsefalseIf set to true, the end states (opened/closed) will also deactivate the buttons for that direction (i.e. the "up" button will be disabled when the shutters are fully open)

Remark : you can also just give the entity ID (without to specify entity:) if you don't need to specify the other configurations.

Sample

type: 'custom:shutter-card'
title: My shutters
entities:
  - entity: cover.left_living_shutter
    name: Left shutter
    buttons_position: left
    title_position: bottom
  - cover.bedroom_shutter

Install

If you use HACS, the resources will automatically be configured with the needed file.

If you don't use HACS, you can download js file from latest releases. Drop it then in www folder in your config directory. Next add the following entry in lovelace configuration:

resources:
  - url: /local/hass-shutter-card.js
    type: module