Mi Humidifier Card

A sleek and responsive Home Assistant Lovelace card for controlling Xiaomi Mi Humidifier (Deerma) devices. This custom card provides an intuitive interface for managing your smart humidifier with features like target humidity control, water level monitoring, and real-time status updates. Built with TypeScript and Lit Element, it offers a modern, dark theme-compatible design that seamlessly integrates with your Home Assistant dashboard.

Screenshots

Device View

Card View

Features

• 🎯 Target humidity control with slider and +/- buttons
• 💧 Water level monitoring with status indicator
• ⚡ Power control with loading states
• 🎨 Modern, responsive design
• 🌙 Dark theme support
• 🔄 Real-time status updates

Changelog

[1.0.0] - 2023-12-23

• Initial release
• Target humidity control with slider and buttons
• Water level monitoring
• Power control with loading states
• Modern, responsive design
• Dark theme support
• Real-time status updates
• Unit tests and documentation

Installation

HACS (Recommended)

1. Open HACS in your Home Assistant instance
2. Go to "Frontend" section
3. Click the menu icon in the top right and select "Custom repositories"
4. Add this repository URL with category "Lovelace"
5. Install "Mi Humidifier Card"
6. Refresh your browser

Manual Installation

1. Download ha-mi-humidifier-card.js from the latest release
2. Copy it to your config/www folder
3. Add the resource in your dashboard:

   resources:
     - url: /local/ha-mi-humidifier-card.js
       type: module

4. Refresh your browser

Configuration

Add the card to your dashboard with this configuration:

type: custom:ha-mi-humidifier-card
entity: humidifier.your_mi_humidifier_entity

Options

Name	Type	Default	Description
entity	string	Required	Your Mi Humidifier entity ID

Development

Prerequisites

• Node.js (v14 or later)
• Home Assistant instance

Setup

1. Clone this repository
2. Install dependencies:

   npm install

3. Start development server:

   npm start

4. The card will be served at http://localhost:5000/ha-mi-humidifier-card.js

Building

npm run build

Built files will be in the dist folder.

Testing

The project uses Jest for unit testing. Tests are written in TypeScript and located in src/*.test.ts files.

To run tests:

npm test

To run tests in watch mode:

npm run test:watch

Current test coverage includes:

• Configuration validation
• Target humidity control
• State management
• Error handling

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Before submitting:

1. Make sure all tests pass
2. Add tests for new features
3. Follow the existing code style
4. Update documentation as needed

License

This project is under the MIT License. See the LICENSE file for details.

Support

If you find this card helpful, please consider:

• Giving it a ⭐️ on GitHub
• Sharing it with others
• Contributing to its development