Overview
Generic device summary card that rolls manufacturer, connectivity, battery, firmware, and key related entities into a single Lovelace card template. Cuts down repetitive per-device YAML and keeps device drill-downs consistent across integrations. Built with TypeScript for Home Assistant’s Lovelace stack, distributed through HACS, and actively used across the homeassistant-extras ecosystem.
README
Overview
A custom card for Home Assistant that provides a comprehensive overview of any device in your system. The card organizes device information into expandable sections. An Integration Card variant displays all devices from a selected integration domain.
Documentation
Full documentation is available at: homeassistant-extras.github.io/device-card
Quick Start
Device Card
type: custom:device-card
device_id: YOUR_DEVICE_ID
Or use an entity ID and the card will automatically determine the device:
type: custom:device-card
entity_id: sensor.your_entity_id
Integration Card
type: custom:integration-card
integration: zwave_js
Installation
HACS (Recommended)
- Open HACS in your Home Assistant instance
- Click the menu icon in the top right and select "Custom repositories"
- Add:
https://github.com/homeassistant-extras/device-card - Select "Dashboard" as the category
- Click "Install"
Manual Installation
- Download
device-card.jsfrom the latest release - Copy to
www/community/device-card/ - Add to your
configuration.yaml:
lovelace:
resources:
- url: /local/community/device-card/device-card.js
type: module
Contributing
- Join the Discussions - Share your insights, provide feedback, or ask questions
- Report Issues - Submit bugs or feature requests
- Submit Pull Requests - Review open PRs and submit your own
- Check out Discord - Need further help, have ideas, want to chat?
- Check out my other cards!
License
This project is protected under the MIT License. For more details, refer to the LICENSE file.
Acknowledgments
- Built using LitElement
- Inspired by Home Assistant's chip design
- Thanks to all contributors!
Project Roadmap
-
Initial design: Create initial card design -
Enhanced customization: Add more customization options -
Custom section order and exclusions: Set the order in which sections are displayed & exclude things - thanks @andrewjswan -
Entity interactions: Configure tap, hold, and double-tap actions - thanks @andrewjswan -
Status badges: Quick status badges for device state -
Entity filtering: Filter specific entities from display - thanks @andrewjswan, @TTLucian -
Integration Card: Rollup to see all devices - thanks @andrewjswan -
Hide device model: Option to hide device model information - thanks @andrewjswan -
Compact layout: Space-efficient layout option - thanks @andrewjswan -
Column control: Ability to define column count for integration card - thanks @andrewjswan -
Device exclusion: Ability to exclude devices from integration card - thanks @andrewjswan -
Wildcard/regex filtering: Exclude devices/entities by wildcard or regex patterns - thanks @andrewjswan -
Device inclusion: Include only specific devices option - thanks @andrewjswan -
Entity & device sorting: Add ability to sort entities - thanks @andrewjswan, @rudi159 -
Card expansion: Ability to expand/collapse the device card - thanks @fgamache1 -
Pinned entity state: Add pinned state entity display - thanks @fgamache1 -
Integration title control: Modify/hide integration card title - thanks @andrewjswan -
Hide title feature: Device card can remove title -
Section exclusion: Add ability to exclude sections - thanks @ctallc -
Entity ID support: Alternative to device_id - card automatically determines device - thanks @potat0man -
Random bugs & improvements: pointing out issues to improve card - thanks @PedroKTFC, @misc-brabs! -
Translations / Localization: support for multiple languages and localized text - thanks @Bsector -
Inverse percent colors: Invert percent bar colors for entities like disk usage - thanks @misc-brabs -
Jinja template support: Certain config properties support Jinja - thanks @LenirSantiago -
Auto-entities support:entityconfig property for auto-entities integration - thanks @misc-brabs -
Heading icon: Entity icon next to card heading when entity_id/entity is configured - thanks @LennartPl
