Skip to content

nevries/hass-shutter-card

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Name Type Required Default Description
type string True - Must be "custom:shutter-card"
title string False - Title of the card

Entities

Name Type Required Default Description
entity string True - The shutter entity ID
name string False Friendly name of the entity Name to display for the shutter
buttons_position string False left Set buttons on left, right, top or bottom of the shutter
title_position string False top Set title on top or on bottom of the shutter, if set to hide neither the name nor the current position will be shown
invert_percentage boolean False false Set it to true if your shutter is 100% when it is closed, and 0% when it is opened
can_tilt boolean False false Set it to true if your shutters support tilting.
partial_close_percentage int False 0 Set 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_percentage int False 0 Set it to a percentage (0-100) of travel that will still be considered a "closed" state in the visualization.
always_percentage boolean False false If set to true, the end states (opened/closed) will be also as numbers (0 / 100 % ) instead of a text
shutter_width_px int False 153 Set shutter visualization width in px. You can make it thicker or narrower to fit your layout.
show_buttons boolean False true If set to false, the up/stop/down buttons are not shown
always_enable_end_buttons boolean False false If set to true, the up/down buttons are enabled even if the cover is an end state
show_slide_percentage boolean False true If set to false, the target percentage will not be shown while dragging the slide

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

About

Shutter card for Home Assistant Lovelace UI

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%