https://github.com/marcelhoogantink/enhanced-shutter-card
An Enhanced Shutter Card for Home Assistant
https://github.com/marcelhoogantink/enhanced-shutter-card
card cover hacs-plugin home-assistant shutter
Last synced: about 2 months ago
JSON representation
An Enhanced Shutter Card for Home Assistant
- Host: GitHub
- URL: https://github.com/marcelhoogantink/enhanced-shutter-card
- Owner: marcelhoogantink
- License: gpl-3.0
- Created: 2024-10-28T17:14:53.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-06T16:16:43.000Z (about 2 months ago)
- Last Synced: 2026-05-06T18:43:05.842Z (about 2 months ago)
- Topics: card, cover, hacs-plugin, home-assistant, shutter
- Language: JavaScript
- Homepage:
- Size: 6.44 MB
- Stars: 113
- Watchers: 5
- Forks: 10
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Enhanced Shutter Card
[](https://github.com/custom-components/hacs) [](https://buymeacoffee.com/marcelhoogantink)
---
## Installation:
Use this button:
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=marcelhoogantink&repository=enhanced-shutter-card&category=plugin)
...and download the card, or use HACS, search for `Enhanced Shutter Card`.
The resources will automatically be configured with the needed files.
When this all is done, you can find the card in Home Assistant in `custom cards` under the `By Card` tab in the list of available cards when building a Dashboard:
*(When unfortunately both options above don't work, you need to add this repository as a Custom Repository.
See for installing Custom Repositories this [hacs-custom-repositories](https://www.hacs.xyz/docs/faq/custom_repositories/) page.
Enter repository-url: `https://github.com/marcelhoogantink/enhanced-shutter-card.git` and choose type: `Dashboard`.)*
When you're done, you can...
Star ⭐ Enhanced Shutter Card on GitHub
... and ...
Thank you !
---
### New in version v1.6.0:
- #### New `auto`-option for finding sub-entities
For the `battery_entity` and `signal_entity` settings, a new added option `auto` is available. When this is set to `auto`, the Card tries to find a battery or signal entity in the device of the cover-entity and displays its icon and status.
Examples:
`battery_entity: auto`
`signal_entity: auto`
Of course, you can still enter the name of these sub-entities.
- #### New option `stacked` implementing horizontal stacked card.
With the new setting `stacked` (default `vertical`), you can create a horizontal stacked Card by setting `stacked: horizontal`.
This setting has automatic horizontal scroll-bars when the cover does not fit in the section.
This is a `global` Card-setting.
- #### Group-member display.
When displaying a cover-group, it is now possible to display the group-members in stead of the group-cover itself.
Use the new `show_group_members` setting and set it `true` like `show_group_members: true`.
When you also use the `auto` setting for the sub-entitties (see above), the Card wil search for these entities for each group-member separately
- #### Place battery and Signal icons on Top or Bottom.
New option to put the battery and signal icons on top or bottom of the card: `icons_position` (default `top`).
Set to `icons_position: bottom` to move the icons to the bottom of the card.
- #### Added counter for group member names
When using grouped covers and `show_group_memebers: true`, Adding an `@` to the defined `name` wil put a number at the `@` in the name of the group-member.
- #### Force format values to zero decimals
Force format values to prevent unneeded decimals.(solves [#131](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/131))
- #### Improved battery- and signal-icons placements
- #### new options: `show_open_close_slider` en `show_window`
When there is little room, eq. on your mobile, you can hide the main-window-image by `show_window: false` (default `true`) and use a slider `show_open_close_slider: true` (default `false`). You can use both settings independently of each other.
This solves also [#154](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/154) and expands the options to hide/view parts of the card.
- #### new options `show_tilt_slider` and `show_tilt_buttons`
For the tilt-section (when the cover can tilt), the setting `show_tilt_slider` is introduced. Together with `show_tilt_buttons` you can set the tilt options the way you like.
This also solves [#153](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/153)
- #### renamed settings (deprecations)
To make the enabling/disalbling of element of the Card more straightforward, all these setting are now aligned to
`show_XXXX` being true or false:
| new name | old name (deprecated)| comment|
| -- | -- | -- |
| show_name | name_disabled | reversed setting (`true`<>`false`) |
| show_opening | opening_disabled | reversed setting (`true`<>`false`) |
| show_tilt_button | tilt_slider_only | reversed setting (`true`<>`false`) |
| show_tilt_slider | show_tilt | same setting |
| show_standard_buttons | disable_standard_buttons | reversed setting (`true`<>`false`) |
| show_partial_open_buttons | disable_partial_open_buttons | reversed setting (`true`<>`false`) |
| show_window | - | new |
| show_open_close_slider | - | new |
- #### new option for `preset_shutter`
A new `preset_shutter`-option is now available: `compact` for little displays like a mobile-phone, displaying a tiny card without the (big) main window, but instead with a slider for opening/closing (see `show_window` and `show_open_close_slider` options).
- #### Complete rebuild of the release process.
- #### Solved issues:
- [#51](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/51) How to do a Horizonal Stack?
- [#131](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/131) Battery percentage - display precision
- [#132](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/132) Multiple Shade Row Card
- [#153](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/153) (bug) Tilt options!
- [#154](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/154) Configuration variable to hide the central graphical window (Minimalist UI)
- [#159](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/159) Percentage precision
- [#160](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/160) Show Dividers between Group Row entities
- [#161](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/161) [FR] modify Entity names in Stack, they are messy :)
- [#163](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/163) [Bug] beta3 completely broke everything - stacked and not stacked
- [#156](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/156) (bug) Curtain buttons do not show left and right, but up and down
- [#157](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/157) (bug) unreachable code after return statement
---
### For previous release-changes go to [Previous-release changes](#previous-release-changes)
---
## All functions of the Card
This card allows besides opening, closing or setting a shutter to the opening rate you want, also many options to design your shutter by combining the sizes and images you want.
Ths shutter can close in down-, left- of right-direction.
It is a follow-up of [Deejayfool/Shuttercard](https://github.com/Deejayfool/hass-shutter-card), a nice Card for Shutters.
I started with a simple change for the motion of the shutters, but soon it became a huge update.
Due to the inactivity of the Shutter Card, I decided to add this one as 'Enhanced Shutter Card' to HACS.
It supports all options of the original Card, but also graphical options like different backgrounds, windows an shutters.
Also the sizes of every shutter can be altered:
(_find below the yaml for this example._)
By default (`preset_shutter` = `roller-shutter`) the card has 3 colored windows and shutter images, ands two background views in the package for verical shutters:
| color | window-image | shutter-slat image | shutter-bottom-bar image | default |
| ----- | --------------- | --------------------- | ------------------------ | ------- |
| grey | esc-window.png | esc-shutter-slat.png | esc-shutter-bottom.png | yes |
| brown | esc-window2.png | esc-shutter-slat2.png | esc-shutter-bottom2.png | no |
| green | esc-window3.png | esc-shutter-slat3.png | esc-shutter-bottom3.png | no |
For horizontal shutter (`preset_shutter` = `curtain`) there is one image:
| color | window-image | shutter-slat image | shutter-bottom-bar image | default |
| ----- | ------------ | ------------------ | ------------------------ | ------- |
| red | [see above] | esc-curtain.png | [none] | yes |
For awnings (`preset_shutter` = `awning`) there is one set of images:
| color | window-image | shutter-slat image | shutter-bottom-bar image | default |
| --------- | ------------ | ------------------ | ------------------------ | ------- |
| red/white | [see above] | esc-awning.png | esc-awning-bottom.png | yes |
These are the avialable background views:
| view filename | default |
| ------------- | ------- |
| esc-view.png | yes |
| esc-view2.png | no |
These images can be combined like in the example above. For (optinal) defintion of the location of the images, a setting 'image_map" does exits.
The default map-setting can be found in the Configuration-info below.
It is also possible to enter a full path in the imagename itself. When a '/' is found in the image-name, the image-name is considerd to include a full path.
And last but not least, the `view_image` and `shutter_slat_image`-settings also accept HTML-color definitions like `red`, `green`, `'#AAFFEE'` or `rgb(255,255,0)` in stead of an image-filename. (The `#` input needs quotes around it in YAML)
## Configuration
In the table below all the possible settings are listed.
The columns _Global_ and _Local_ show whether the setting can be used in the card header or in the `entities` section in the `- entity` sections.
The settings are defined in the follwing logic:
- first Global:
- The program defaults are taken. (See foe these defaults in the `Default`column below)
- These settings are overruled with the settings of the `shutter_preset` setting in the global section. (see `Shutter Presets`)
- Then all other entered settings in the global section are taken into account.
- then per `- entity`:
- These settings are now overruled with the defined settings of the `shutter_preset` setting for this entity.
- Then, at last, all other settings under this entity section are taken into account.
### General
| Name | Type | Required | Default | Global | Local | Description | Remarks |
| ---------------------------- | ------------- | -------- | --------------------------------------------- | ------ | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| type | string | Yes | - | Yes | No | Must be "custom:enhanced-shutter-card" | |
| title | string | no | - | Yes | No | Title of the card | |
| stacked | string | no | vertical | Yes | No | Set the stacked direction when using multiple covers in one Card. | |
| name | string | No | _Friendly name of the entity_ | No | Yes | Name to display for the shutter. When using `show_group_members: true` for grouped covers, A `@` can be used to put a number in the name of each member. | |
| shutter_preset | string | no | roller-shutter | Yes | Yes | Several preset-shutters-setting-groups, which creates a good start-setting for a specific type of cover. See the table below for possible definitions and the settings of them | |
| battery_entity | string | No | `null` | Yes | Yes | EntityId of the sensor represenating the battery-level of the shutter (as a number), or `auto` for automatic search. For global setting just use `auto` for automatic search | |
| signal_entity | string | No | `null` | Yes | Yes | EntityId of the sensor represenating the Wireless signal-level of the shutter (as a number), or `auto` for automatic search. For global setting just use `auto` for automatic search | |
| show_group_members | boolean | No | `false` | Yes | Yes | When using a grouped-cover in the Card, set to 'true'to display the member covers in stead of the group-cover. | |
| passive_mode | boolean | no | `false` | Yes | Yes | Interface works normal, but no action is sent to the shutters. A lock-icon is shown after the shutter-name. | |
| image_map | string | No | /local/community/enhanced-shutter-card/images | Yes | Yes | map of the images. Change thsi when using own images. | |
| window_image | string | No | esc-window.png | Yes | Yes | image of the window shutter. | |
| view_image | string | No | esc-back-view.png | Yes | Yes | background-image through the window, or a HTML color. | |
| shutter_slat_image | string | No | esc-shutter-slat.png | Yes | Yes | Image of one slat of the shutter. | |
| shutter_bottom_image | string | No | esc-shutter-bottom.png | Yes | Yes | the bottom bar of the shutter. | |
| rotate_slat_image | boolean | No | `true` | Yes | Yes | defines whether the `shutter_slat_image` wil rotate with the closing_direction (`true`) or not (`false`) | |
| stretch_bottom_image | boolean | No | `true` | Yes | Yes | defines whether the `shutter_bottom_image` wil be stretched to the windows-size (`true`) or not (`false`). (Only perpendicular to the `closing_direction`) | |
| base_height_px | int | No | 150 | Yes | Yes | height of image in pixels. | |
| base_width_px | int | No | 150 | Yes | Yes | witdh of image in pixels. | |
| resize_height_pct | int | No | 100 | Yes | Yes | resize of the base height in percent. (limited between 20% and 500%) | |
| resize_width_pct | int | No | 100 | Yes | Yes | resize of the base width in percent. (limited between 20% and 500%) | |
| top_offset_pct | int | No | 0 | Yes | Yes | space between top image/window and top shutter. | |
| bottom_offset_pct | int | No | 0 | Yes | Yes | space between bottom image/window and bottom shutter. | |
| closing_direction | string | No | `down` | Yes | Yes | Set the closing direction: `down`, `left` or `right`. | |
| buttons_position | string | No | `left` | Yes | Yes | Set buttons on `left`, `right`, `top` or `bottom` of the shutter. For automatic placement on Landscape or Portrait-format of the visible Dashboard, you can also use the `auto-top-left` (or `auto`), `auto-top-right`, `auto-bottom-left` or `auto-bottom-right` options. | |
| scale_texts | boolean/float | No | `false` | Yes | Yes | Scale the texts according to the window-size (`true`) or scale it with a factor (`0.5` - `2.0`) | |
| scale_buttons | boolean/float | No | `false` | Yes | Yes | Scale the buttons when the windows-image gets smaller then 150px in the direction of the button-placement (`true`), or scale it with a factor (`0.5` - `2.0`). | |
| scale_icons | boolean/float | No | `true` | Yes | Yes | Scale the icon for battery and signal icons windows-image gets smaller then 150px in the horizonal direction (`true`), or scale it with a factor (`0.5` - `2.0`). | |
| name_position | string | No | `top` | Yes | Yes | Set title/name shutter on `top` or on `bottom` of the shutter image. | |
| opening_position | string | No | _name_position_ -setting | Yes | Yes | set position info of shutter on `top` or `bottom` of the shutter image. | |
| inline_header | boolean | No | `false` | Yes | Yes | place the shutter-header (name and position) in one line. | |
| invert_percentage_ui | boolean | No | `false` | Yes | Yes | Inverts the percentage on UI-level when set to `true`. Will not change the cover behavior. | |
| invert_percentage_cover | boolean | No | `false` | Yes | Yes | Inverts the precentage on device-level when set to `true`. Possibly changes to cover behavior. | |
| invert_open_close_ui | boolean | No | `false` | Yes | Yes | Inverts the open-close texts on UI-level when set to `true`. Will not change the cover behavior. | |
| invert_open_close_cover | boolean | No | `false` | Yes | Yes | Inverts the opec-close commands on device-level when set to `true`. Possibly changes to cover behavior. | |
| invert_percentage_tilt_ui | boolean | No | `false` | Yes | Yes | Inverts the tilt-percentage on UI-level when set to `true`. Will not change the cover-tilt behavior. | |
| invert_percentage_tilt_cover | boolean | No | `false` | Yes | Yes | Inverts the tilt-percentage on device-level when set to `true`. Possibly changes to cover-tilt behavior. | |
| tilt_angle_max | int | No | 180 | Yes | Yes | Maximum angle for visualiation of the tilt-function. This is representation for the 100% value of the tilt-value. | |
| tilt_angle_min | int | No | 0 | Yes | Yes | Minimum angle for visualiation of the tilt-function. This is representation for the 0% value of the tilt-value. | |
| partial_close_percentage | int | No | 0 | Yes | Yes | 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 | No | 0 | Yes | Yes | Set it to a percentage (0-100) of travel that will still be considered a "closed" state in the visualization. | |
| always_percentage | boolean | No | `false` | Yes | Yes | If set to `true`, the end states (opened/closed) will be also as numbers (0 / 100 % ) instead of a text | |
| disable_end_buttons | boolean | No | `false` | Yes | Yes | If set to `true`, the end states (opened/closed) will also deactivate the buttons for that direction (i.e. the "up" button | |
| button_up_hide_states | string list | No | empty list | Yes | Yes | Entered state strings (`opening`, `open`, `closed`, `closing` or `partial_open`) added will hide the `up` button when the cover is in any of the listed states. This can be combined with other `*_hide_states` options. | |
| button_stop_hide_states | string list | No | empty list | Yes | Yes | Entered state strings (`opening`, `open`, `closed`, `closing` or `partial_open`) added will hide the `stop` button when the cover is in any of the listed states. This can be combined with other `*_hide_states` options. | |
| button_down_hide_states | string list | No | empty list | Yes | Yes | Entered state strings (`opening`, `open`, `closed`, `closing` or `partial_open`) added will hide the `down` button when the cover is in any of the listed states. This can be combined with other `*_hide_states` options. | |
| show_window | boolean | No | `true` | Yes | Yes | Show main window (or not) | |
| show_name | boolean | No | `true` | Yes | Yes | Show the cover name (or not) | |
| show_opening | boolean | No | `true` | Yes | Yes | Show the cover position (and tilt) (or not) | |
| show_standard_buttons | boolean | No | `true` | Yes | Yes | Show the standard button block (or not) | |
| show_open_close_slider | boolean | No | `false` | Yes | Yes | Show Show the slider for open and close (or not) | |
| show_tilt_buttons | boolean | No | `true` | Yes | Yes | Show tilt button block (or not) (only active when cover supprts tilt) | |
| show_tilt_slider | boolean | No | `true` | Yes | Yes | Show tilt slider (or not) (only active when cover supprts tilt) | |
| show_partial_open_buttons | boolean | No | `true` | Yes | Yes | Show partail open button-block (or not) | |
| **deprecated** | | | | Yes | Yes | Show main window (or not) | |
| name_disabled | boolean | No | `false` | Yes | Yes | hide title/name of shutter | deprecated |
| opening_disabled | boolean | No | `false` | Yes | Yes | hide position info of shutter | deprecated |
| show_tilt | boolean | No | `true` | Yes | Yes | Show the `tilt` options and buttons, only active when the shutter supports `tilt` | deprecated |
| tilt_slider_only | boolean | No | `false` | Yes | Yes | Display only the tilt-silder, not the buttons and visualisation. Only active when the cover supports`tilt` and `show_tilt` equals `true` | deprecated |
| disable_standard_buttons | boolean | No | `false` | Yes | Yes | Show or hide the default up, down and stop buttons | deprecated |
| disable_partial_open_buttons | boolean | No | `true` | Yes | Yes | Show or hide the partial open buttons. | deprecated |
_Remark: you can also just give the entity ID (without to specify `entity:`) if you don't need to specify the other configurations._
### Shutter Presets
The following `shutter_preset` settings are available:
| **Preset Name** | **Setting** | **Value** |
| ------------------ | --------------------------- | --------------------- |
| **roller-shutter** | `rotate_slat_image` | `true` |
| | `name` | Roller Shutter |
| **awning** | `invert_open_close_ui` | `true` |
| | `invert_percentage_ui` | `true` |
| | `shutter_slat_image` | esc-awning.png |
| | `shutter_bottom_image` | esc-awning-bottom.png |
| | `bottom_offset_pct` | 50 |
| | `stretch_bottom_image` | `false` |
| | `closing_direction` | `down` |
| | `name` | Awning |
| **curtain** | `closing_direction` | `right` |
| | `shutter_slat_image` | esc-curtain.png |
| | `shutter_bottom_image` | '' |
| | `rotate_slat_image` | `false` |
| | `closing_direction` | `down` |
| | `name` | Curtain |
| **shade** | `shutter_slat_image` | `'#00000080'` |
| | `closing_direction` | `down` |
| | `name` | Shade |
| **blind** | `closing_direction` | `right` |
| | `shutter_slat_image` | esc-awning.png |
| | `rotate_slat_image` | `false` |
| | `windows_image` | esc-windows2.png |
| | `shutter_bottom_image` | '' |
| | `name` | `Blind` |
| **compact** | `show_window` | `false` |
| | `show_name` | `true` |
| | `show_opening` | `true` |
| | `show_standard_buttons` | `true` |
| | `show_open_close_slider` | `true` |
| | `show_tilt_buttons` | `true` |
| | `show_tilt_slider` | `true` |
| | `show_partial_open_buttons` | `false` |
| | `name` | Compact |
### Sample
The samples below are the settings of the example image above.
```yaml
type: custom:enhanced-shutter-card
title: Shutter Samples
name_position: top
entities:
- entity: cover.demo1
name: Variable Hidden Standard Buttons
view_image: esc-view2.png
passive_mode: false
name_position: top
base_height_px: 180
button_up_hide_states:
- open
- opening
- closing
button_down_hide_states:
- closed
- opening
- closing
button_stop_hide_states:
- open
- closed
- partial_open
- entity: cover.demo2
name: Passive Mode
passive_mode: true
partial_close_percentage: 85
name_position: top
base_height_px: 100
base_width_px: 160
shutter_slat_image: esc-shutter-slat2.png
window_image: esc-window3.png
disable_partial_open_buttons: true
always_percentage: true
invert_percentage_ui: false
invert_percentage_cover: false
- entity: cover.demo3
name: Include Partial Open Buttons
disable_end_buttons: true
window_image: esc-window2.png
resize_width_pct: 70
name_position: top
disable_partial_open_buttons: false
```
---
## Previous release-changes:
---
### New in version v1.5.2:
Improved Tilt (3d-tilt) and tilt slat visible at 90 degrees.
- #### Solved issues:
[#151](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/151) Does not work anymore without internet access
---
### New in version v1.5.1:
#### Version `v1.5.1` is the Tilt-version !!!
Now, fully tilt capacities are included:
 
Also a new preset setting-option is added: `shutter_preset: blind`. This one is used in the example above.
- #### New tilt-setting options are added:
- ##### New option [invert_percentage_tilt_ui]
(boolean) Invert/alter the setting for tilt-percentage on user-interface level. (default `false`)
- ##### New option [invert_percentage_tilt_cover]
(boolean) Invert/alter the setting for tilt-percentage on device level. (default `false`)
- ##### New option [tilt_slider_only]
(boolean) Display only the tilt-silder, not the buttons and visualisation (default `false`)
Only active when the cover has a tilt option and `show_tilt` equals `true`
- ##### New option [tilt_angle_min]
(int) Set the maximum tilt-level (in degrees)
values between [0] and [180] and less then `tilt_angle_max` (default 0)
This value is for tilt-visualisation, the value send to the cover are always from 100 (for `tilt_angle_max`) to 0 (for `tilt_angle_min`)
- ##### New option [tilt_angle_max]
(int) Set the minimum tilt-level (in degrees)
values between [0] and [180] and greater then `tilt_angle_min` (default 180)
This value is for tilt-visualisation, the value send to the cover are always from 100 (for `tilt_angle_max`) to 0 (for `tilt_angle_min`)
- #### Solved issues:
- [#100](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/100) Roller Shades with Tilt
- [#45](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/45) [Feature Request] Add tilt positional options and icons to the Card
- [#145](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/145) Extra options for new tilt function
### New in version v1.4.3:
This a interim release for (hopefully) repairing all the problems and issues that this card had with variuos cover-types.
With this changes and new settings all different behavior should be possible to handle.
It is possible that your cover changes its hehavior with this release. As I do just have one type of cover, I cannot check types I do not have.
If your cover changed its behavior with this release, you need to play with the four settings below to get te wanted behavior.
Typically start with setting all four options to false, and then alter the `invert_percentage_cover` and `invert_open_close_cover` to change the behavior of the cover. When that works OK, alter the visual settings (`invert_percentage_ui` and `invert_open_close_ui`) to your wishes
When you do not get it done, please raise an issue for it on Github.
- #### Improved settings for open/close and percentage setting for controling device invert-settings:
- ##### invert_percentage_cover (boolean)
(from deprecated setting `invert_percentage`)
Invert/alter the setting for percentage on device level.
- ##### invert_open_close_cover (boolean)
(new definiton)
Invert/alter the setting for open-close on device level.
- ##### invert_percentage_ui (boolean)
(new definiton)
Invert/alter the setting for percentage on user-interface level.
- ##### invert_open_close_ui (boolean)
(from deprecated setting `invert_open_close`)
Invert/alter the setting for open-close on user-interface level.
Often used for awnings.
See for default and possible settings [in this table](#configuration).
With these four options all differnent behavior the different coevr-types should be possible to handle
- #### Solved issues:
- [#121](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/121) Have a small problem with the buttons on the right ...
- [#123](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/123) Open_close And invert_percentage issue
- [#125](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/125) Invert Status does not update image
- [#136](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/136) Shutter card no longer visible with v1.4.2
---
### New in version v1.3.1:
- #### Handling not-found images
When an image entered in the Card is not found, the default image for the image-type wil be used, and a warning is sent to the console.
- #### Wrong open/close texts in the position header for awnings.
The wrong open/closed/opening/closing texts for awnings are corrected.
- #### Inactive Buttons improved.
When is shutter is (temporary) unavailable the buttons are now still active, so it may trigger the cover to activate.
- #### battery percentage icon
If the battery percentage > 100%, the icon will still be displayed.
- #### Solved issues:
- [#115](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/115) shutter-card disappeared
- [#117](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/117) Buttons inactive after update
- [#118](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/118) Awning problem
- [#119](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/119) Fix issue with battery percentage over 100%
---
### New in version v1.3.0:
- #### [BREAKING CHANGES] *(sorry!!)*
- ##### Automatic curtain image setting stops
In version 1.2.3, the card automaticly chooses for `esc-curtain.png` for displaying a curtain instead of a cover, when setting `closing-direction` to`left` or `right`. This stops in version 1.3.0 due to the new preset-option `shutter_preset`.
Solving this breaking-change starts with adding the setting `shutter_preset = curtain` in your Card-YAML-code.
For more inforamtion on this, see this new option below and in the Configuration chapter
- ##### Changes in automatic card rescale and fitting
The automatic scaling of the card was not very stable and created unpredictable results sometimes. So this is changed.
Because of this change cards, might have some size changes, and there is a risc that not all cards still fit in your dashboard unchanged.
- #### New option: [shutter_preset]
This version introduces the option `shutter_preset`. Setting this to a type, predefines the Card to display a correct setting of that type.
Current types are: `shutter`, `shade`, `curtain` and `awning`.
The pre-settings of these shutter_presets can be overridden by or supplemented with other settings.
See also the Configuration chapter.
- #### Image definitions do now accept colors and colorcodes
All images settings (except `window_image`) now accept colors and colorcodes besides image-filenames, like `red` or `'#aaf1bb'` like `view_image` already did.
- #### New option: [invert_open_close].
For awnings, a new options is introduced: `invert_open_close` (true/false) for making the card more logic for this kind of covering. Use `true` for awnings.
(This setting is also activated by using a new option `shutter_preset`: `shutter_preset = awning`)
- #### extending `scale_buttons` and `scale_icons`
Extending `scale_buttons` and `scale_iconswith` posibiility to define a scalefactor besides `false` or `true`. Like `scale_buttons: 1.5`
- #### new option `scale_texts`
new option `scale_texts` for scaling tests, options are: `true`, `false` or a factor like `1.5` or `0.7`
- #### new option `rotate_slat_image`
new option `rotate_slat_image` defines whether the `shutter_slat_image` rotates with the set `closing_direction` (`true`) or stays fixed (`false`)
- #### new option `stretch_bottom_image`
new option `stretch_bottom_image` defines whether the `shutter_bottom_image` wil be stretched to the shutter-width (`true`) or will be repeated using fixed image-size (`false`).
this streching is only perpendicular to the closing direction.
- #### Solved issues:
- [#52](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/52) [Bug] Icons not scaling, too small to see
- [#60](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/60) Title font size
- [#88](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/88) Question only
- [#91](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/91) Add transparent white Horizontal moving shutters
- [#95](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/95) [FEATURE REQUEST] Invert arrow functionality
- [#97](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/97) Shutter image horizontal shrink when command buttons are on the left or on the right
- [#98](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/98) Invert open/close
- [#99](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/99) [Code Share] Really difficult way to get this card to have a control page
- [#101](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/101) Awning Buttons & Transparency
- [#103](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/103) [Feature Request] Add shade support #103
- [#104](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/104) Card as “custom_fields” in a button-card.
- [#108](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/108) How disable "partially close" button
- [#109](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/109) Dashboard not updating properly. Intermittent incomplete dashboards
- [#111](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/111) invert_percentage: true causes appearance of "partial close" button
- [#113](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/113) View layout with error: Unknown keyword: [view_layout], check your input!
---
### New in version v1.2.3:
- #### Enhanced Shutter Card is now part of the default HACS-repositories :tada: :tada:
- #### Solved ussues:
- [#72](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/72) Unable to open/close the shutter in scroll view on mobile.
- [#68](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/72) Background colors not working (already solved in v1.2.1)
---
### New in version v1.2.0:
- #### Card funtionality is now controled by the `supported_features` attribute of the shutter.
The Card now reads the supported-features attributesof the cover, and acts on it.
Therefore the `can_tilt`option is changed into `show_tilt`
- #### Horizontal moving shutters (left to right, right to left)
Horizontal moving shutters are now possible. Add `closing_direction` to your settings, and give it the value `left`, `right` or `down`.
Setting `down` is default.
For horizontal moving shutters (curtains), a new image is added: `esc_curtain.png`
- #### Warnings (unknown/deprected/removed items) while editing the shutters in YAML.
To help you with defining your settings, unknown/deprecated/removed messaged are shown when defing your card in YAML.
- #### can_tilt is deprecated , use show_tilt
`can_tilt` option is replace by `show_tilt`, due to the Card is now reading and acting on `supported-features`-attribute of the shutter.
- #### calculated grid-space for the card (in rows and colums) is displayed while editing the card in yaml.
For more control on the size of the Card, the needed Gridsize (rows, columsn) are shown while editing the Card in Yaml.
For more information on the Gridsize, see: https://developers.home-assistant.io/docs/frontend/custom-ui/custom-card/#sizing-in-sections-view.
- #### option `title_position`is removed.
after some time `deprecated` this setting is now `removed`,use `name_position`.
- #### solved issues:
- [#59](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/59) Size and Toggle.
- [#57](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/57) Stop-button not showing up.
- [#56](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/56) Current position of shutter not updated in card with MQTT cover
- [#54](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/54) Movement arrow display bug when shutter is in movement
- [#49](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/49) Full path option for images
- [#48](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/48) 6 buttons on right works inversed and ‘invert_percentage’ true or false has no effect as sliding shutter
- [#44](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/44) Vertical space larger than required
- [#43](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/43) rotate shutter 90°
---
### New in version v1.1.4:
- #### New: Battery and Signal level display
New settings `battery_entity` and `signal_entity` for displaying battery and signal icon with level-information.
New settings `scale_icons` for activating scaling of the icons when the image is made smaller.
- #### Card works now 100% local.
The card inludes now the lit-libary, no internet-connection needed after downloading.
- #### Solved [Error#46 ](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/46) (Custom element does not exist) solved.
This error is found and removed.
- #### Improved sizing of the Card
New settings `battery_entity` and `signal_entity` for displaying battery and signal icon with level-information.
New settings `scale_icons` for activating scaling of the icons when the image is made smaller.
- #### Solved [Error#46 ](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/46) (Custom element does not exist)
This bug is found and removed.
- #### Improved sizing of the Card
The sizing of the card is further improved. (This can result in little differences in size with previous versions)
### New in version v1.1.3:
- #### New automatic placement of the buttons
New automatic placement of the buttons according to Landscape or Portrait format of the visible part of the dashboard. Using the new settings `auto-top-left` (or `auto`), `auto-top-right`, `auto-bottom-left` or `auto-bottom-right` for the optional option `buttons_position`, the card wil change the button positions to top or botton on Portrait and Left or Right in Landscape, automaticly.
- #### inline_header
New setting (`true` of `false`). When set to `true`, the card wil place the Name and Position information in one line, as long as possible. In this mode, only the `opening_position` option will be used for the `bottom`/`top` placement of the full shutter header, the `opening_position`wil be discarded.
- #### scale_buttons
New setting (`true` of `false`). When set to `true` the buttons will be rescaled (smaller) when the windows-image is getting smaller then 150px. The width is taken into account when the resulting button_position is `left` or `right`, the heieght is used when `buttons_position`is `top` or `bottom`. This will work also with the new `auto*` options.
- #### further improvement of responsiveness.
The responsiveness of the card is further improved.