šŸ”˜ Piotras Smart Button

:radio_button: Piotras Smart Button

A high-performance button card for Home Assistant — Most cards go silent after calling a service. This one tells you it worked.

:sparkles: Features

  • Visual Editor — full GUI with tabs: General, Size, Background, Icon, Text, Layout, Slider & Power, Filters, Actions, Service. No manual YAML needed.
  • 9-Grid Layout System — place Icon, Name, and State badge independently across a 3Ɨ3 matrix.
  • Adaptive Auto-Sliders — smart detection of Brightness, Color Temp, Volume, Cover Position, Fan Speed. Zero configuration required.
  • Dynamic Backgrounds — solid color, 2/3-color gradients, or full-resolution background images.
  • Smart Filter Engine — CSS filters (brightness, saturation, grayscale) applied automatically per ON/OFF state.
  • Service Countdown — animated SVG circle or progress bar after call-service, with optional card blockade.
  • Power Monitoring — real-time consumption bar with configurable pulse warning threshold.
  • Font Styles — 4 text presets for Name and State labels.
  • Advanced Action Engine — Tap, Double-Tap, and Hold, optimized for both mobile and desktop.
  • Visual Editor Full GUI — General, Size, Background, Icon, Text, Layout, Slider & Power, Filters, Actions, Service tabs. No YAML required.

:compass: Navigation Mode

:bulb: Light & Auto-Dimmer Slider


:electric_plug: Socket & Power Monitoring


:scroll: Script Button


:loud_sound: Media Player


:gear: Installation

Method 1: Via HACS (Recommended)

  1. Click the button below to automatically add the repository to your HACS:
Open your Home Assistant instance
  1. Click Add in the pop-up window.
  2. Once the repository page opens, click Download.
  3. After downloading, do a Hard reload of your browser.

Method 2: Manual Installation

  1. Download this repository as a ZIP file and extract it.
  2. Inside your Home Assistant config/www/ directory, create a new folder named piotras-smart-button.
  3. Copy the compiled files (from dist/ folder) into config/www/piotras-smart-button/.
  4. Go to Settings → Dashboards → Resources.
  5. Click Add Resource and enter:
/local/piotras-smart-button/piotras-smart-button-loader.js?v=1.0.0
  • Resource type: JavaScript Module
  1. Hard reload your browser (Ctrl+Shift+R).

You should also upload the source code to github, not just the dist files :eyes:

Thanks for the suggestion. Currently, I’m focusing on refining the stable dist version to ensure the best user experience. The full source code will be made available alongside the official HACS release. If the official Home Assistant HACS submission process requires it, the repository will be updated accordingly. For now, my priority is delivering a polished final product. Please stay tuned for the official HACS launch.

Release v1.1.0

Editor Fix — Config State Display + Minor Card Fixes

Fixed editor incorrectly showing default values instead of actual YAML config. Toggles, number and text fields now correctly reflect saved state. Minor card fix: removed hardcoded widths on service bar and slider zones — now fully responsive to card_width setting.