Skip to content
This repository was archived by the owner on Nov 2, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@ All notable changes to this project are documented here. The format follows

## [Unreleased]

### Changed

- The card moved into [ha-managed-switch](https://github.com/eizedev/ha-managed-switch) 0.6.0; this repository is archived.

## [0.2.0] - 2026-10-30

### Added
Expand Down
69 changes: 12 additions & 57 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,59 +1,14 @@
# Managed Switch Card for Home Assistant

| HACS | Release | CI | License |
| ---- | ------- | -- | ------- |
| [![HACS custom](https://img.shields.io/badge/HACS-custom-41BDF5?cacheSeconds=3600)](https://hacs.xyz/docs/faq/custom_repositories/) | [![Release](https://img.shields.io/github/v/release/eizedev/managed-switch-card?cacheSeconds=3600)](https://github.com/eizedev/managed-switch-card/releases) | [![CI](https://github.com/eizedev/managed-switch-card/actions/workflows/ci.yml/badge.svg)](https://github.com/eizedev/managed-switch-card/actions/workflows/ci.yml) | [![License](https://img.shields.io/github/license/eizedev/managed-switch-card?cacheSeconds=3600)](https://github.com/eizedev/managed-switch-card/blob/main/LICENSE) |

<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/eizedev/managed-switch-card/main/assets/header-dark.svg">
<img alt="Managed Switch Card for Home Assistant" src="https://raw.githubusercontent.com/eizedev/managed-switch-card/main/assets/header-light.svg" height="72">
</picture>

A dashboard card that draws your **managed switches** like their own web interface: every port
coloured by link and speed, uplinks to other switches, trunk members, PoE delivering power, and
the device connected to each port. It shows what the
[Managed Switch (SNMP)](https://github.com/eizedev/ha-managed-switch) integration reads.

[![Open your Home Assistant instance and open this repository in HACS.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=eizedev&repository=managed-switch-card&category=plugin)

<img src="https://raw.githubusercontent.com/eizedev/managed-switch-card/main/assets/card.png" alt="Three switches as cards: green ports at 1 Gbit/s, orange at 100 Mbit/s, empty without link, a link symbol on the ports between the switches, the device name under each port" width="100%">

**Documentation: [ha-managed-switch.eize.dev/card](https://ha-managed-switch.eize.dev/card/)**

## Install

1. Install the integration [Managed Switch (SNMP)](https://github.com/eizedev/ha-managed-switch) 0.2.0 or newer and add your switches.
2. In HACS, add this repository as a custom repository of the type *Dashboard* (or use the button
above), install **Managed Switch Card** and reload the browser:

```text
https://github.com/eizedev/managed-switch-card
```

3. Edit a dashboard, *Add card*, **Managed Switch**, and choose the switch.

## Configuration

```yaml
type: custom:managed-switch-card
device_id: 0123456789abcdef0123456789abcdef # the switch, chosen in the card's dialog
title: Hallway # optional, else the switch's name
show_names: true # device names under the ports (default)
show_speed: true # speed in the ports: 1G, 100, 10 (default)
show_rates: false # data rates; the integration's rate sensors must be on
layout: # optional: your own front panel, by port name
rows: [["1", "3", "5", "7"], ["2", "4", "6", "8"]]
sfp: ["9", "10"]
```

Details, colours and your own layout: [documentation](https://ha-managed-switch.eize.dev/card/).

## Contributing

A layout for your switch model helps most: see [CONTRIBUTING.md](https://github.com/eizedev/managed-switch-card/blob/main/CONTRIBUTING.md);
for security issues [SECURITY.md](https://github.com/eizedev/managed-switch-card/blob/main/SECURITY.md).

## License

[MIT](https://github.com/eizedev/managed-switch-card/blob/main/LICENSE). Provided "as is", without warranty of any kind. The header images are CC BY 4.0;
their source is in [eizedev/brand](https://github.com/eizedev/brand).
This repository is archived. The card is part of the integration
[Managed Switch (SNMP)](https://github.com/eizedev/ha-managed-switch) from version 0.6.0: it loads
in Home Assistant on its own and is updated with the integration. Its source is in
[`card/`](https://github.com/eizedev/ha-managed-switch/tree/main/card) there, and the
documentation is at [ha-managed-switch.eize.dev/card](https://ha-managed-switch.eize.dev/card/).

If you installed the card from this repository: update the integration to 0.6.0 or newer, then
remove *Managed Switch Card* in HACS and its entry under *Settings*, *Dashboards*, *Resources*.
Your cards keep working.

Issues and layouts for new switch models go to
[ha-managed-switch](https://github.com/eizedev/ha-managed-switch/issues).
Loading