Z-Wave card set (Zooz)

Overview

A coordinated set of custom Lovelace cards for Zooz and compatible Z-Wave devices so switches, sensors, and energy reporting look and behave consistently across the dashboard. Reduces one-off YAML and copy-paste card configs by packaging opinionated layouts for Z-Wave JS users. TypeScript implementation with HACS delivery and CI for reliable releases.

README

<img src="assets/z-wave.png" align="center" width="50%"> <h1 align="center">Z-Wave Card Set</h1> Boosting your Z-Wave integration.

Built with the tools and technologies: <img src="https://img.shields.io/badge/npm-CB3837.svg?style=for-the-badge&logo=npm&logoColor=white" alt="npm"> <img src="https://img.shields.io/badge/Prettier-F7B93E.svg?style=for-the-badge&logo=Prettier&logoColor=black" alt="Prettier"> <img src="https://img.shields.io/badge/TypeScript-3178C6.svg?style=for-the-badge&logo=TypeScript&logoColor=white" alt="TypeScript"> <img src="https://img.shields.io/badge/GitHub%20Actions-2088FF.svg?style=for-the-badge&logo=GitHub-Actions&logoColor=white" alt="GitHub%20Actions"> <img src="https://img.shields.io/badge/Lit-324FFF.svg?style=for-the-badge&logo=Lit&logoColor=white" alt="Lit">

Overview

This project brings a set of cards to display info about your Z-Wave devices. Many of these are great if you have a dedicated status view for your network or connected devices.

Cards

Z-Wave Device Info

Universal card for all Z-Wave devices showing detailed device information and controls.

Device Center

See all your devices and their states and some controls if applicable in one place.

Z-Wave Nodes Status Card

Shows status and last seen time of all your nodes.

Hub Card

Shows info about the Z-Wave Hub.

Installation

HACS (Recommended)

Open HACS in your Home Assistant instance
Click the menu icon in the top right and select "Custom repositories"
Add this repository URL and select "Dashboard" as the category
- https://github.com/homeassistant-extras/zwave-card-set
Click "Install"

Manual Installation

Download the zwave-card-set.js file from the latest release in the Releases tab.
Copy it to your www/community/zwave-card-set/ folder
Add the following to your configuration.yaml (or add as a resource in dashboards menu)

lovelace:
  resources:
    - url: /local/community/zwave-card-set/zwave-card-set.js
      type: module

Add the cards to your dashboard using the UI editor or YAML.

Configuration Options

See the README files of the individual cards for configuration and detailed information.

Some cards may require the hub to be labeled with a "Hub" label:

Supported Devices

All Z-Wave devices are supported through the universal Device Info card. I have tested mainly Zooz devices as this is my Z-Wave devices of choice. Let me know if you have any issues and we'll get them fixed!

Project Roadmap

Initial design: create initial room card based on button-card template in UI minimialist theme.
Editors: make sure stub configs and previews are solid.
Node cards: show info about different nodes.
Node status card sizing: make sizing dynamic, can't figure it out.
Device Center: add docs and pics towards end.
Themes: test default theme, etc.
Node Info bugs: fix title, firmware, etc. - thanks @minchinweb
Custom tap actions: can ping nodes on the status card and custom actions - thanks @pjschaffer
Node status filtering: add filters to show/hide dead, active, and sleeping nodes - thanks @dimatx

Contributing

💬 Join the Discussions: Share your insights, provide feedback, or ask questions.
🐛 Report Issues: Submit bugs found or log feature requests for the zwave-card-set project.
💡 Submit Pull Requests: Review open PRs, and submit your own PRs.
📣 Check out discord: Need further help, have ideas, want to chat?
🃏 Check out my other cards! Maybe you have an integration that I made cards for.

<details closed> <summary>Contributing Guidelines</summary>

Fork the Repository: Start by forking the project repository to your github account.
Clone Locally: Clone the forked repository to your local machine using a git client.
```
git clone https://github.com/homeassistant-extras/zwave-card-set
```
Create a New Branch: Always work on a new branch, giving it a descriptive name.
```
git checkout -b new-feature-x
```
Make Your Changes: Develop and test your changes locally.
Commit Your Changes: Commit with a clear message describing your updates.
```
git commit -m 'Implemented new feature x.'
```
Push to github: Push the changes to your forked repository.
```
git push origin new-feature-x
```
Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.
Review: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!