{"id":18073229,"url":"https://github.com/marcelhoogantink/enhanced-shutter-card","last_synced_at":"2026-05-11T14:02:40.873Z","repository":{"id":259936825,"uuid":"879861835","full_name":"marcelhoogantink/enhanced-shutter-card","owner":"marcelhoogantink","description":"An Enhanced Shutter Card for Home Assistant","archived":false,"fork":false,"pushed_at":"2026-05-06T16:16:43.000Z","size":6758,"stargazers_count":113,"open_issues_count":23,"forks_count":10,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-05-06T18:43:05.842Z","etag":null,"topics":["card","cover","hacs-plugin","home-assistant","shutter"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marcelhoogantink.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-28T17:14:53.000Z","updated_at":"2026-05-06T16:16:47.000Z","dependencies_parsed_at":"2025-12-18T21:03:27.934Z","dependency_job_id":null,"html_url":"https://github.com/marcelhoogantink/enhanced-shutter-card","commit_stats":null,"previous_names":["marcelhoogantink/enhanced-shutter-card"],"tags_count":76,"template":false,"template_full_name":null,"purl":"pkg:github/marcelhoogantink/enhanced-shutter-card","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcelhoogantink%2Fenhanced-shutter-card","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcelhoogantink%2Fenhanced-shutter-card/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcelhoogantink%2Fenhanced-shutter-card/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcelhoogantink%2Fenhanced-shutter-card/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marcelhoogantink","download_url":"https://codeload.github.com/marcelhoogantink/enhanced-shutter-card/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcelhoogantink%2Fenhanced-shutter-card/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32795416,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["card","cover","hacs-plugin","home-assistant","shutter"],"created_at":"2024-10-31T10:05:39.772Z","updated_at":"2026-05-08T20:01:30.687Z","avatar_url":"https://github.com/marcelhoogantink.png","language":"JavaScript","funding_links":["https://buymeacoffee.com/marcelhoogantink","https://www.buymeacoffee.com/marcelhoogantink"],"categories":[],"sub_categories":[],"readme":"# Enhanced Shutter Card\n\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg?style=for-the-badge)](https://github.com/custom-components/hacs) [![buymeacoffee_badge](https://img.shields.io/badge/Donate-Buymeacoffee-orange?style=for-the-badge)](https://buymeacoffee.com/marcelhoogantink)\n---\n\n## Installation:\n\nUse this button:\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=marcelhoogantink\u0026repository=enhanced-shutter-card\u0026category=plugin)\n...and download the card, or use HACS, search for `Enhanced Shutter Card`.\nThe resources will automatically be configured with the needed files.\n\nWhen 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:\n\n![alt text](example.png)\n\n\u003csmall\u003e*(When unfortunately both options above don't work, you need to add this repository as a Custom Repository.\nSee for installing Custom Repositories this [hacs-custom-repositories](https://www.hacs.xyz/docs/faq/custom_repositories/) page.\nEnter repository-url: `https://github.com/marcelhoogantink/enhanced-shutter-card.git` and choose type: `Dashboard`.)\u003c/small\u003e*\n\n\nWhen you're done, you can...\n\nStar \u003ca href=\"https://github.com/marcelhoogantink/enhanced-shutter-card\" target=\"_blank\"\u003e  ⭐ \u003cb\u003eEnhanced Shutter Card\u003c/b\u003e \u003c/a\u003e on GitHub\n\n ... and ...\n\n\u003ca href=\"https://www.buymeacoffee.com/marcelhoogantink\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" height= \"60px\" width=  \"217px\" \u003e\u003c/a\u003e\n\nThank you !\n\n---\n### New in version v1.6.0:\n\n- #### New `auto`-option for finding sub-entities\n  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.\n\n  Examples:\n    `battery_entity: auto`\n    `signal_entity: auto`\n\n  Of course, you can still enter the name of these sub-entities.\n\n- #### New option `stacked` implementing horizontal stacked card.\n  With the new setting `stacked` (default `vertical`), you can create a horizontal stacked Card by setting `stacked: horizontal`.\n  This setting has automatic horizontal scroll-bars when the cover does not fit in the section.\n  This is a `global` Card-setting.\n- #### Group-member display.\n  When displaying a cover-group, it is now possible to display the group-members in stead of the group-cover itself.\n  Use the new `show_group_members` setting and set it `true` like `show_group_members: true`.\n  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\n- #### Place battery and Signal icons on Top or Bottom.\n  New option to put the battery and signal icons on top or bottom of the card: `icons_position` (default `top`).\n  Set to `icons_position: bottom` to move the icons to the bottom of the card.\n- #### Added counter for group member names\n  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.\n- #### Force format values to zero decimals\n  Force format values to prevent unneeded decimals.(solves [#131](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/131))\n- #### Improved battery- and signal-icons placements\n- #### new options: `show_open_close_slider` en `show_window`\n  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.\n\n  This solves also [#154](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/154) and expands the options to hide/view parts of the card.\n\n- #### new options `show_tilt_slider` and `show_tilt_buttons`\n  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.\n  This also solves [#153](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/153)\n\n- #### renamed settings (deprecations)\n\n  To make the enabling/disalbling of element of the Card more straightforward, all these setting are now aligned to\n  `show_XXXX` being true or false:\n    | new name | old name (deprecated)| comment|\n    | -- | -- | -- |\n    | show_name | name_disabled | reversed setting (`true`\u003c\u003e`false`) |\n    | show_opening | opening_disabled | reversed setting (`true`\u003c\u003e`false`) |\n    | show_tilt_button | tilt_slider_only | reversed setting (`true`\u003c\u003e`false`) |\n    | show_tilt_slider | show_tilt | same setting |\n    | show_standard_buttons | disable_standard_buttons | reversed setting (`true`\u003c\u003e`false`) |\n    | show_partial_open_buttons | disable_partial_open_buttons | reversed setting (`true`\u003c\u003e`false`) |\n    | show_window | - | new |\n    | show_open_close_slider | - | new |\n\n\n\n- #### new option for `preset_shutter`\n  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).\n- #### Complete rebuild of the release process.\n- #### Solved issues:\n  - [#51](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/51) How to do a Horizonal Stack?\n  - [#131](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/131) Battery percentage - display precision\n  - [#132](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/132) Multiple Shade Row Card\n  - [#153](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/153) (bug) Tilt options!\n  - [#154](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/154) Configuration variable to hide the central graphical window (Minimalist UI)\n  - [#159](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/159) Percentage precision\n  - [#160](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/160) Show Dividers between Group Row entities\n  - [#161](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/161) [FR] modify Entity names in Stack, they are messy :)\n  - [#163](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/163) [Bug] beta3 completely broke everything - stacked and not stacked\n\n  - [#156](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/156) (bug) Curtain buttons do not show left and right, but up and down\n  - [#157](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/157) (bug) unreachable code after return statement\n\n---\n### For previous release-changes go to [Previous-release changes](#previous-release-changes)\n---\n\n## All functions of the Card\n\nThis 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.\n\nThs shutter can close in down-, left- of right-direction.\n\nIt is a follow-up of [Deejayfool/Shuttercard](https://github.com/Deejayfool/hass-shutter-card), a nice Card for Shutters.\nI started with a simple change for the motion of the shutters, but soon it became a huge update.\nDue to the inactivity of the Shutter Card, I decided to add this one as 'Enhanced Shutter Card' to HACS.\n\nIt supports all options of the original Card, but also graphical options like different backgrounds, windows an shutters.\nAlso the sizes of every shutter can be altered:\n\n![Enhanced Shutter Card](EnhancedShutterCardNew.gif)\n\n(_find below the yaml for this example._)\n\nBy default (`preset_shutter` = `roller-shutter`) the card has 3 colored windows and shutter images, ands two background views in the package for verical shutters:\n\n| color | window-image    | shutter-slat image    | shutter-bottom-bar image | default |\n| ----- | --------------- | --------------------- | ------------------------ | ------- |\n| grey  | esc-window.png  | esc-shutter-slat.png  | esc-shutter-bottom.png   | yes     |\n| brown | esc-window2.png | esc-shutter-slat2.png | esc-shutter-bottom2.png  | no      |\n| green | esc-window3.png | esc-shutter-slat3.png | esc-shutter-bottom3.png  | no      |\n\nFor horizontal shutter (`preset_shutter` = `curtain`) there is one image:\n\n| color | window-image | shutter-slat image | shutter-bottom-bar image | default |\n| ----- | ------------ | ------------------ | ------------------------ | ------- |\n| red   | [see above]  | esc-curtain.png    | [none]                   | yes     |\n\nFor awnings (`preset_shutter` = `awning`) there is one set of images:\n\n| color     | window-image | shutter-slat image | shutter-bottom-bar image | default |\n| --------- | ------------ | ------------------ | ------------------------ | ------- |\n| red/white | [see above]  | esc-awning.png     | esc-awning-bottom.png    | yes     |\n\nThese are the avialable background views:\n\n| view filename | default |\n| ------------- | ------- |\n| esc-view.png  | yes     |\n| esc-view2.png | no      |\n\nThese images can be combined like in the example above. For (optinal) defintion of the location of the images, a setting 'image_map\" does exits.\nThe default map-setting can be found in the Configuration-info below.\nIt 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.\nAnd 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)\n\n## Configuration\n\nIn the table below all the possible settings are listed.\nThe columns _Global_ and _Local_ show whether the setting can be used in the card header or in the  `entities`  section in the `- entity` sections.\nThe settings are defined in the follwing logic:\n- first Global:\n  - The program defaults are taken. (See foe these defaults in the `Default`column below)\n  - These settings are overruled with the settings of the `shutter_preset` setting in the global section. (see `Shutter Presets`)\n  - Then all other entered settings in the global section are taken into account.\n- then per `- entity`:\n  - These settings are now overruled with the defined settings of the `shutter_preset` setting for this entity.\n  - Then, at last, all other settings under this entity section are taken into account.\n\n### General\n\n|             Name             |     Type      | Required |                    Default                    | Global | Local |                                                                                                                                Description                                                                                                                                 |  Remarks   |\n| ---------------------------- | ------------- | -------- | --------------------------------------------- | ------ | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |\n| type                         | string        | Yes      | -                                             | Yes    | No    | Must be \"custom:enhanced-shutter-card\"                                                                                                                                                                                                                                     |            |\n| title                        | string        | no       | -                                             | Yes    | No    | Title of the card                                                                                                                                                                                                                                                          |            |\n| stacked                      | string        | no       | vertical                                      | Yes    | No    | Set the stacked direction when using multiple covers in one Card.                                                                                                                                                                                                          |            |\n| 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.                                                                                                                   |            |\n| 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                                                                                             |            |\n| 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                                                                                               |            |\n| 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                                                                                       |            |\n| 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.                                                                                                                                                             |            |\n| 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.                                                                                                                                                                |            |\n| image_map                    | string        | No       | /local/community/enhanced-shutter-card/images | Yes    | Yes   | map of the images. Change thsi when using own images.                                                                                                                                                                                                                      |            |\n| window_image                 | string        | No       | esc-window.png                                | Yes    | Yes   | image of the window shutter.                                                                                                                                                                                                                                               |            |\n| view_image                   | string        | No       | esc-back-view.png                             | Yes    | Yes   | background-image through the window, or a HTML color.                                                                                                                                                                                                                      |            |\n| shutter_slat_image           | string        | No       | esc-shutter-slat.png                          | Yes    | Yes   | Image of one slat of the shutter.                                                                                                                                                                                                                                          |            |\n| shutter_bottom_image         | string        | No       | esc-shutter-bottom.png                        | Yes    | Yes   | the bottom bar of the shutter.                                                                                                                                                                                                                                             |            |\n| rotate_slat_image            | boolean       | No       | `true`                                        | Yes    | Yes   | defines whether the `shutter_slat_image` wil rotate with the closing_direction (`true`) or not (`false`)                                                                                                                                                                   |            |\n| 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`)                                                                                                                |            |\n| base_height_px               | int           | No       | 150                                           | Yes    | Yes   | height of image in pixels.                                                                                                                                                                                                                                                 |            |\n| base_width_px                | int           | No       | 150                                           | Yes    | Yes   | witdh of image in pixels.                                                                                                                                                                                                                                                  |            |\n| resize_height_pct            | int           | No       | 100                                           | Yes    | Yes   | resize of the base height in percent. (limited between 20% and 500%)                                                                                                                                                                                                       |            |\n| resize_width_pct             | int           | No       | 100                                           | Yes    | Yes   | resize of the base width in percent. (limited between 20% and 500%)                                                                                                                                                                                                        |            |\n| top_offset_pct               | int           | No       | 0                                             | Yes    | Yes   | space between top image/window and top shutter.                                                                                                                                                                                                                            |            |\n| bottom_offset_pct            | int           | No       | 0                                             | Yes    | Yes   | space between bottom image/window and bottom shutter.                                                                                                                                                                                                                      |            |\n| closing_direction            | string        | No       | `down`                                        | Yes    | Yes   | Set the closing direction: `down`, `left` or `right`.                                                                                                                                                                                                                      |            |\n| 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. |            |\n| 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`)                                                                                                                                                                            |            |\n| 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`).                                                                                                             |            |\n| 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`).                                                                                                          |            |\n| name_position                | string        | No       | `top`                                         | Yes    | Yes   | Set title/name shutter on `top` or on `bottom` of the shutter image.                                                                                                                                                                                                       |            |\n| opening_position             | string        | No       | _name_position_ -setting                      | Yes    | Yes   | set position info of shutter on `top` or `bottom` of the shutter image.                                                                                                                                                                                                    |            |\n| inline_header                | boolean       | No       | `false`                                       | Yes    | Yes   | place the shutter-header (name and position) in one line.                                                                                                                                                                                                                  |            |\n| invert_percentage_ui         | boolean       | No       | `false`                                       | Yes    | Yes   | Inverts the percentage on UI-level when set to `true`. Will not change the cover behavior.                                                                                                                                                                                 |            |\n| invert_percentage_cover      | boolean       | No       | `false`                                       | Yes    | Yes   | Inverts the precentage on device-level when set to `true`. Possibly changes to cover behavior.                                                                                                                                                                             |            |\n| 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.                                                                                                                                                                           |            |\n| 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.                                                                                                                                                                    |            |\n| 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.                                                                                                                                                                       |            |\n| 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.                                                                                                                                                                   |            |\n| 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.                                                                                                                                                          |            |\n| 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.                                                                                                                                                            |            |\n| 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.                                                                                                                                                       |            |\n| 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.                                                                                                                                                              |            |\n| 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                                                                                                                                                                    |            |\n| 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                                                                                                                                                 |            |\n| 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.                                                   |            |\n| 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.                                                 |            |\n| 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.                                                 |            |\n| show_window                  | boolean       | No       | `true`                                        | Yes    | Yes   | Show main window (or not)                                                                                                                                                                                                                                                  |            |\n| show_name                    | boolean       | No       | `true`                                        | Yes    | Yes   | Show the cover name (or not)                                                                                                                                                                                                                                               |            |\n| show_opening                 | boolean       | No       | `true`                                        | Yes    | Yes   | Show the cover position (and tilt) (or not)                                                                                                                                                                                                                                |            |\n| show_standard_buttons        | boolean       | No       | `true`                                        | Yes    | Yes   | Show the standard button block (or not)                                                                                                                                                                                                                                    |            |\n| show_open_close_slider       | boolean       | No       | `false`                                       | Yes    | Yes   | Show Show the slider for open and close (or not)                                                                                                                                                                                                                           |            |\n| show_tilt_buttons            | boolean       | No       | `true`                                        | Yes    | Yes   | Show tilt button block (or not) (only active when cover supprts tilt)                                                                                                                                                                                                      |            |\n| show_tilt_slider             | boolean       | No       | `true`                                        | Yes    | Yes   | Show tilt slider (or not) (only active when cover supprts tilt)                                                                                                                                                                                                            |            |\n| show_partial_open_buttons    | boolean       | No       | `true`                                        | Yes    | Yes   | Show partail open button-block (or not)                                                                                                                                                                                                                                    |            |\n| **deprecated**               |               |          |                                               | Yes    | Yes   | Show main window (or not)                                                                                                                                                                                                                                                  |            |\n| name_disabled                | boolean       | No       | `false`                                       | Yes    | Yes   | hide title/name of shutter                                                                                                                                                                                                                                                 | deprecated |\n| opening_disabled             | boolean       | No       | `false`                                       | Yes    | Yes   | hide position info of shutter                                                                                                                                                                                                                                              | deprecated |\n| show_tilt                    | boolean       | No       | `true`                                        | Yes    | Yes   | Show the `tilt` options and buttons, only active when the shutter supports `tilt`                                                                                                                                                                                          | deprecated |\n| 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 |\n| disable_standard_buttons     | boolean       | No       | `false`                                       | Yes    | Yes   | Show or hide the default up, down and stop buttons                                                                                                                                                                                                                         | deprecated |\n| disable_partial_open_buttons | boolean       | No       | `true`                                        | Yes    | Yes   | Show or hide the partial open buttons.                                                                                                                                                                                                                                     | deprecated |\n\n_Remark: you can also just give the entity ID (without to specify `entity:`) if you don't need to specify the other configurations._\n\n### Shutter Presets\nThe following `shutter_preset` settings are available:\n\n|  **Preset Name**   |         **Setting**         |       **Value**       |\n| ------------------ | --------------------------- | --------------------- |\n| **roller-shutter** | `rotate_slat_image`         | `true`                |\n|                    | `name`                      | Roller Shutter        |\n| **awning**         | `invert_open_close_ui`      | `true`                |\n|                    | `invert_percentage_ui`      | `true`                |\n|                    | `shutter_slat_image`        | esc-awning.png        |\n|                    | `shutter_bottom_image`      | esc-awning-bottom.png |\n|                    | `bottom_offset_pct`         | 50                    |\n|                    | `stretch_bottom_image`      | `false`               |\n|                    | `closing_direction`         | `down`                |\n|                    | `name`                      | Awning                |\n| **curtain**        | `closing_direction`         | `right`               |\n|                    | `shutter_slat_image`        | esc-curtain.png       |\n|                    | `shutter_bottom_image`      | ''                    |\n|                    | `rotate_slat_image`         | `false`               |\n|                    | `closing_direction`         | `down`                |\n|                    | `name`                      | Curtain               |\n| **shade**          | `shutter_slat_image`        | `'#00000080'`         |\n|                    | `closing_direction`         | `down`                |\n|                    | `name`                      | Shade                 |\n| **blind**          | `closing_direction`         | `right`               |\n|                    | `shutter_slat_image`        | esc-awning.png        |\n|                    | `rotate_slat_image`         | `false`               |\n|                    | `windows_image`             | esc-windows2.png      |\n|                    | `shutter_bottom_image`      | ''                    |\n|                    | `name`                      | `Blind`               |\n| **compact**        | `show_window`               | `false`               |\n|                    | `show_name`                 | `true`                |\n|                    | `show_opening`              | `true`                |\n|                    | `show_standard_buttons`     | `true`                |\n|                    | `show_open_close_slider`    | `true`                |\n|                    | `show_tilt_buttons`         | `true`                |\n|                    | `show_tilt_slider`          | `true`                |\n|                    | `show_partial_open_buttons` | `false`               |\n|                    | `name`                      | Compact               |\n\n\n### Sample\n\nThe samples below are the settings of the example image above.\n\n```yaml\ntype: custom:enhanced-shutter-card\ntitle: Shutter Samples\nname_position: top\nentities:\n  - entity: cover.demo1\n    name: Variable Hidden Standard Buttons\n    view_image: esc-view2.png\n    passive_mode: false\n    name_position: top\n    base_height_px: 180\n    button_up_hide_states:\n      - open\n      - opening\n      - closing\n    button_down_hide_states:\n      - closed\n      - opening\n      - closing\n    button_stop_hide_states:\n      - open\n      - closed\n      - partial_open\n  - entity: cover.demo2\n    name: Passive Mode\n    passive_mode: true\n    partial_close_percentage: 85\n    name_position: top\n    base_height_px: 100\n    base_width_px: 160\n    shutter_slat_image: esc-shutter-slat2.png\n    window_image: esc-window3.png\n    disable_partial_open_buttons: true\n    always_percentage: true\n    invert_percentage_ui: false\n    invert_percentage_cover: false\n  - entity: cover.demo3\n    name: Include Partial Open Buttons\n    disable_end_buttons: true\n    window_image: esc-window2.png\n    resize_width_pct: 70\n    name_position: top\n    disable_partial_open_buttons: false\n```\n\n---\n## Previous release-changes:\n---\n### New in version v1.5.2:\n\nImproved Tilt (3d-tilt) and tilt slat visible at 90 degrees.\n\n- #### Solved issues:\n\n    [#151](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/151) Does not work anymore without internet access\n\n---\n### New in version v1.5.1:\n\n#### Version `v1.5.1` is the Tilt-version !!!\nNow, fully tilt capacities are included:\n\n  ![FullTiltOptions](FullTiltOptions.gif) ![FullTiltOptions](FullTiltOptions2.gif)\n\nAlso a new preset setting-option is added: `shutter_preset: blind`. This one is used in the example above.\n\n- #### New tilt-setting options are added:\n\n- ##### New option [invert_percentage_tilt_ui]\n  (boolean) Invert/alter the setting for tilt-percentage on user-interface level. (default `false`)\n- ##### New option [invert_percentage_tilt_cover]\n  (boolean) Invert/alter the setting for tilt-percentage on device level. (default `false`)\n- ##### New option [tilt_slider_only]\n  (boolean) Display only the tilt-silder, not the buttons and visualisation (default `false`)\n  Only active when the cover has a tilt option and `show_tilt` equals `true`\n- ##### New option [tilt_angle_min]\n  (int) Set the maximum tilt-level (in degrees)\n  values between [0] and [180] and less then `tilt_angle_max` (default 0)\n  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`)\n- ##### New option [tilt_angle_max]\n  (int) Set the minimum tilt-level (in degrees)\n  values between [0] and [180] and greater then `tilt_angle_min` (default 180)\n  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`)\n\n- #### Solved issues:\n\n  - [#100](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/100) Roller Shades with Tilt\n  - [#45](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/45) [Feature Request] Add tilt positional options and icons to the Card\n  - [#145](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/145) Extra options for new tilt function\n### New in version v1.4.3:\n\nThis a interim release for (hopefully) repairing all the problems and issues that this card had with variuos cover-types.\nWith this changes and new settings all different behavior should be possible to handle.\nIt 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.\nIf your cover changed its behavior with this release, you need to play with the four settings below to get te wanted behavior.\n\nTypically 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\n\nWhen you do not get it done, please raise an issue for it on Github.\n\n- #### Improved settings for open/close and percentage setting for controling device invert-settings:\n\n  - ##### invert_percentage_cover (boolean)\n    (from deprecated setting `invert_percentage`)\n    Invert/alter the setting for percentage on device level.\n\n  - ##### invert_open_close_cover (boolean)\n    (new definiton)\n    Invert/alter the setting for open-close on device level.\n\n  - ##### invert_percentage_ui (boolean)\n    (new definiton)\n    Invert/alter the setting for percentage on user-interface level.\n\n  - ##### invert_open_close_ui (boolean)\n    (from deprecated setting `invert_open_close`)\n    Invert/alter the setting for open-close on user-interface level.\n    Often used for awnings.\n    \u003cbr/\u003e\n\n  See for default and possible settings [in this table](#configuration).\n  With these four options all differnent behavior the different coevr-types should be possible to handle\n\n- #### Solved issues:\n\n  - [#121](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/121) Have a small problem with the buttons on the right ...\n  - [#123](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/123) Open_close And invert_percentage issue\n  - [#125](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/125) Invert Status does not update image\n  - [#136](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/136) Shutter card no longer visible with v1.4.2\n---\n### New in version v1.3.1:\n\n- #### Handling not-found images\n  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.\n- #### Wrong open/close texts in the position header for awnings.\n  The wrong open/closed/opening/closing texts for awnings are corrected.\n- #### Inactive Buttons improved.\n  When is shutter is (temporary) unavailable the buttons are now still active, so it may trigger the cover to activate.\n- #### battery percentage icon\n  If the battery percentage \u003e 100%, the icon will still be displayed.\n\n- #### Solved issues:\n  - [#115](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/115) shutter-card disappeared\n  - [#117](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/117) Buttons inactive after update\n  - [#118](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/118) Awning problem\n  - [#119](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/119) Fix issue with battery percentage over 100%\n\n---\n### New in version v1.3.0:\n\n- #### [BREAKING CHANGES]   \u003csmall\u003e*(sorry!!)*\u003c/small\u003e\n  - ##### Automatic curtain image setting stops\n    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`.\n    Solving this breaking-change starts with adding the setting `shutter_preset = curtain` in your Card-YAML-code.\n    For more inforamtion on this, see this new option below and in the Configuration chapter\n  - ##### Changes in automatic card rescale and fitting\n    The automatic scaling of the card was not very stable and created unpredictable results sometimes. So this is changed.\n    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.\n\n- #### New option: [shutter_preset]\n  This version introduces the option `shutter_preset`. Setting this to a type, predefines the Card to display a correct setting of that type.\n  Current types are: `shutter`, `shade`, `curtain` and `awning`.\n  The pre-settings of these shutter_presets can be overridden by or supplemented with other settings.\n  See also the Configuration chapter.\n- #### Image definitions do now accept colors and colorcodes\n  All images settings (except `window_image`) now accept colors and colorcodes besides image-filenames, like `red` or `'#aaf1bb'` like `view_image` already did.\n- #### New option: [invert_open_close].\n  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.\n  (This setting is also activated by using a new option `shutter_preset`: `shutter_preset = awning`)\n- #### extending `scale_buttons` and `scale_icons`\n  Extending `scale_buttons` and `scale_iconswith` posibiility to define a scalefactor besides `false` or `true`. Like `scale_buttons: 1.5`\n- #### new option `scale_texts`\n  new option `scale_texts` for scaling tests, options are: `true`, `false` or a factor like `1.5` or `0.7`\n- #### new option `rotate_slat_image`\n  new option `rotate_slat_image` defines whether the `shutter_slat_image` rotates with the set `closing_direction` (`true`) or stays fixed (`false`)\n- #### new option `stretch_bottom_image`\n  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`).\n  this streching is only perpendicular to the closing direction.\n- #### Solved issues:\n  - [#52](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/52) [Bug] Icons not scaling, too small to see\n  - [#60](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/60) Title font size\n  - [#88](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/88) Question only\n  - [#91](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/91) Add transparent white Horizontal moving shutters\n  - [#95](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/95) [FEATURE REQUEST] Invert arrow functionality\n  - [#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\n  - [#98](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/98) Invert open/close\n  - [#99](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/99) [Code Share] Really difficult way to get this card to have a control page\n  - [#101](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/101) Awning Buttons \u0026 Transparency\n  - [#103](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/103) [Feature Request] Add shade support #103\n  - [#104](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/104) Card as “custom_fields” in a button-card.\n  - [#108](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/108) How disable \"partially close\" button\n  - [#109](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/109) Dashboard not updating properly. Intermittent incomplete dashboards\n  - [#111](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/111) invert_percentage: true causes appearance of \"partial close\" button\n  - [#113](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/113) View layout with error: Unknown keyword: [view_layout], check your input!\n---\n### New in version v1.2.3:\n\n- #### Enhanced Shutter Card is now part of the default HACS-repositories  :tada: :tada:\n\n- #### Solved ussues:\n  - [#72](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/72) Unable to open/close the shutter in scroll view on mobile.\n  - [#68](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/72) Background colors not working (already solved in v1.2.1)\n\n---\n### New in version v1.2.0:\n\n- #### Card funtionality is now controled by the `supported_features` attribute of the shutter.\n  The Card now reads the supported-features attributesof the cover, and acts on it.\n  Therefore the `can_tilt`option is changed into `show_tilt`\n- #### Horizontal moving shutters (left to right, right to left)\n  Horizontal moving shutters are now possible. Add `closing_direction` to your settings, and give it the value `left`, `right` or `down`.\n  Setting `down` is default.\n\n  ![Curtain](Curtain.gif)\n\n  For horizontal moving shutters (curtains), a new image is added: `esc_curtain.png`\n- #### Warnings (unknown/deprected/removed items) while editing the shutters in YAML.\n  To help you with defining your settings, unknown/deprecated/removed messaged are shown when defing your card in YAML.\n- #### can_tilt is deprecated , use show_tilt\n  `can_tilt` option is replace by `show_tilt`, due to the Card is now reading and acting on `supported-features`-attribute of the shutter.\n- #### calculated grid-space for the card (in rows and colums) is displayed while editing the card in yaml.\n  For more control on the size of the Card, the needed Gridsize (rows, columsn) are shown while editing the Card in Yaml.\n  For more information on the Gridsize, see: https://developers.home-assistant.io/docs/frontend/custom-ui/custom-card/#sizing-in-sections-view.\n- #### option `title_position`is removed.\n  after some time `deprecated` this setting is now `removed`,use `name_position`.\n- #### solved issues:\n  - [#59](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/59) Size and Toggle.\n  - [#57](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/57) Stop-button not showing up.\n  - [#56](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/56) Current position of shutter not updated in card with MQTT cover\n  - [#54](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/54) Movement arrow display bug when shutter is in movement\n  - [#49](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/49) Full path option for images\n  - [#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\n  - [#44](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/44) Vertical space larger than required\n  - [#43](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/43) rotate shutter 90°\n\n---\n\n### New in version v1.1.4:\n\n- #### New: Battery and Signal level display\n\n  New settings `battery_entity` and `signal_entity` for displaying battery and signal icon with level-information.\n  New settings `scale_icons` for activating scaling of the icons when the image is made smaller.\n\n- #### Card works now 100% local.\n\n  The card inludes now the lit-libary, no internet-connection needed after downloading.\n\n- #### Solved [Error#46 ](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/46) (Custom element does not exist) solved.\n\n  This error is found and removed.\n\n- #### Improved sizing of the Card\n\n  New settings `battery_entity` and `signal_entity` for displaying battery and signal icon with level-information.\n  New settings `scale_icons` for activating scaling of the icons when the image is made smaller.\n  ![image](https://github.com/user-attachments/assets/4c0ad49b-e003-4ca8-a64f-3b1fea6d5b68)\n\n- #### Solved [Error#46 ](https://github.com/marcelhoogantink/enhanced-shutter-card/issues/46) (Custom element does not exist)\n  This bug is found and removed.\n\n- #### Improved sizing of the Card\n  The sizing of the card is further improved. (This can result in little differences in size with previous versions)\n\n### New in version v1.1.3:\n\n- #### New automatic placement of the buttons\n  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.\n- #### inline_header\n  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.\n- #### scale_buttons\n  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.\n- #### further improvement of responsiveness.\n  The responsiveness of the card is further improved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcelhoogantink%2Fenhanced-shutter-card","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarcelhoogantink%2Fenhanced-shutter-card","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcelhoogantink%2Fenhanced-shutter-card/lists"}