Skip to content

tolnai/hacs_cover_slider

Repository files navigation

Cover Slider card for Home Assistant

HACS Total downloads Downloads of latest version (latest by SemVer) Current version

This is a custom card loaded via HACS into Home Assistant, which shows sliders for cover type entities. Sliders can go both vertically and horizontally.

The card has a visual editor, but all configuration options are detailed below.

Check out my other work at https://github.com/tolnai/home_assistant_cookbook.

Samples

Basic example

Vertical example

Horizontal example

Options

Name Type Default Description
type string Required custom:cover-slider-card
entities array Required Entities configured as below
direction string vertical Slider direction: vertical, horizontal, horizontal-invert
layout string full Layout: full, compact, stop, minimal
hideNames boolean false Hides names of entities. Not recommended for horizontal sliders.
titleSize number 14 Title size in px
percentageSize number 10 Percentage size in px
sliderWidth number 40 Width of sliders in px
sliderHeight number 200 Length of sliders in px
step number 5 Default slider step size (you'll get 100/step positions)
showPercentage boolean false Display current percentage
percentagePosition string besides / under Show percentage besides or under name? Default is besides for horizontal direction and under for vertical direction.
openColor string Default color used for open area
closedColor string Default color used for closed area
upIcon icon mdi:arrow-up Default upper/left icon
downIcon icon mdi:arrow-down Default lower/right icon
upLabel string Up Default label of upper/left icon
downLabel string Down Default label of lower/right icon
tap_action action Default tap action
hold_action action Default hold action
double_tap_action action Default default tap action

The meaning of layouts:

  • full: Full (all buttons)
  • compact: Compact (stop appears during movement)
  • stop: Stop (only Stop button)
  • minimal: Minimal (no buttons, only slider)

Some options can be set on a global level (defaults), but can be overridden on an entity level.

This card supports actions, which can be triggered by tapping on the cover names, with the usual home assistant type of configuration. These can also be set on a global and entity level as well.

Entity options

Name Type Default Description
entity entity Required Cover entity
name string entity's name Show this name instead entity's name
invert boolean false Inverts 0/100 position values
step number 5 Slider step size (you'll get 100/step positions)
openColor string Individual color used for open area
closedColor string Individual color used for closed area
upIcon icon mdi:arrow-up Individual upper/left icon
downIcon icon mdi:arrow-down Individual lower/right icon
upLabel string Up Individual label of upper/left icon
downLabel string Down Individual label of lower/right icon
tap_action action Tap action
hold_action action Hold action
double_tap_action action Default tap action

Installation

Preferred method of installation is Home Assistant Community Store.

  • Open HACS in Home Assistant, Click the "..." menu, Custom repositories
  • Cope the URL of this repo (https://github.com/tolnai/hacs_cover_slider) and press Add
  • Search for "cover slider", pick "Cover Slider card" from the list, press Download
  • After reloading the page, the card will be available in the card picker

Examples

Basic example

type: custom:cover-slider-card
entities:
  - entity: cover.cover_1
  - entity: cover.cover_2
  - entity: cover.cover_3
  - entity: cover.cover_4

Horizontal example

type: custom:cover-slider-card
entities:
  - entity: cover.shade_1
    name: 'Kitchen'
  - entity: cover.shade_2
    name: 'Living room'
direction: horizontal-invert
layout: compact
step: 5
upIcon: mdi:arrow-collapse-horizontal
downIcon: mdi:arrow-expand-horizontal
upLabel: In
downLabel: Out

Full example

type: custom:cover-slider-card
entities:
  - entity: cover.cover_1
    name: 'South 1'
    invert: True
    step: 10
    tap_action:
      action: none
  - entity: cover.cover_2
    name: 'South 2'
    invert: True
    step: 10
  - entity: cover.cover_3
    name: 'West 1'
  - entity: cover.cover_4
    name: 'West 2'
  - entity: cover.covers_group
    name: 'All'
    openColor: ''
    closedColor: hsl(200, 20%, 20%)
    upIcon: mdi:arrow-up-bold
    downIcon: mdi:arrow-down-bold
    upLabel: All up
    downLabel: All down
direction: vertical
layout: full
hideNames: false
sliderWidth: 40
sliderHeight: 200
step: 5
showPercentage: true
percentagePosition: under
openColor: ''
closedColor: ''
upIcon: mdi-arrow-left
downIcon: mdi:arrow-right
upLabel: 'Up'
downLabel: 'Down'
titleSize: 14
percentageSize: 10
tap_action:
  action: navigate
  navigation_path: /mypage

Credits

Inspired by:

Buy Me A Coffee

About

Slider cover card for Home Assistant

Resources

License

Stars

Watchers

Forks

Packages

No packages published