explaingit

rickyfont94/climate-cluster-card

Analysis updated 2026-05-18

20JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A dual-ring, car-dashboard style Home Assistant card for controlling an AC or heat pump's temperature, fan, mode, and extra toggles.

Mindmap

mindmap
  root((Climate Cluster Card))
    What it does
      Wide arc dial
      Two ring control
      Mode popup
    Tech stack
      JavaScript
      Web component
      HACS
    Use cases
      Control AC temperature
      Control fan speed
      Toggle swing LED sound
    Audience
      Home Assistant users
      Smart home tinkerers
    License
      MIT

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add a car dashboard style dual-ring control for an air conditioner to a Home Assistant dashboard.

USE CASE 2

Control target temperature and fan speed together with a single drag gesture.

USE CASE 3

Add custom toggle chips for device features Home Assistant does not auto-detect, like anti-mildew mode.

USE CASE 4

Style the card as a frosted glass panel that blends with a dashboard's wallpaper.

What is it built with?

JavaScriptHome AssistantHACS

How does it compare?

rickyfont94/climate-cluster-cardaaronz345/athena-personal-academic-pagealana72212/akamai-vm
Stars202020
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderatehard
Complexity2/52/55/5
Audiencegeneralresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Installs via HACS as a custom repository with no build step or extra dependencies.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Climate Cluster Card is a custom dashboard card for Home Assistant, the open source smart home platform, that gives an air conditioner or heat pump entity a car dashboard style control face instead of a plain thermostat widget. It shows two concentric rings on a wide arc gauge: dragging the inner ring sets the target temperature and dragging the outer ring sets the fan speed, both at the same time. Tapping the center opens a frosted glass style popup for picking the mode, such as cool, heat, dry, fan only, auto, or off. Beyond the main dial, the card includes toggle chips for things like swing direction, an LED display, and beep or sound settings, which automatically connect to matching sibling entities when the underlying device exposes them, and it was built and tested specifically against Midea brand air conditioners while still working with any generic Home Assistant climate entity. A newer option called extra toggles lets a user add their own switches or selectable entities as chips in the popup, useful for device features the card does not automatically detect, like an anti-mildew or gentle wind mode. The visual style itself can also be customized: a frosted glass appearance option with adjustable tint and opacity lets the card blend into a dashboard's wallpaper, and a full point and click editor is provided so none of this requires editing configuration files by hand. Technically, the card is written in plain JavaScript as a single self-contained web component with no external dependencies and no build step required to use it. It installs through HACS, the Home Assistant Community Store, as a custom repository, or can be added manually. The project is actively maintained with a running changelog of touch responsiveness fixes, swing control fixes for devices that use named vane positions rather than a simple on and off, and editor usability improvements like renaming mode buttons and toggle labels without touching YAML. The project's code is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install climate-cluster-card into my Home Assistant setup through HACS.
Prompt 2
Show me how to configure the extra_toggles option to add a custom switch entity as a chip.
Prompt 3
Explain how to set up the frosted glass appearance option with a custom tint and opacity.
Prompt 4
Walk me through configuring this card for my Midea air conditioner's swing and LED entities.

Frequently asked questions

What is climate-cluster-card?

A dual-ring, car-dashboard style Home Assistant card for controlling an AC or heat pump's temperature, fan, mode, and extra toggles.

What language is climate-cluster-card written in?

Mainly JavaScript. The stack also includes JavaScript, Home Assistant, HACS.

What license does climate-cluster-card use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is climate-cluster-card to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is climate-cluster-card for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.