https://github.com/randrcomputers/ha-lymow-card
Custom Home Assistant Lovelace card for the Lymow-HA integration — Lymow One Plus controls, map, stats, and generic dock artwork.
https://github.com/randrcomputers/ha-lymow-card
Last synced: 5 days ago
JSON representation
Custom Home Assistant Lovelace card for the Lymow-HA integration — Lymow One Plus controls, map, stats, and generic dock artwork.
- Host: GitHub
- URL: https://github.com/randrcomputers/ha-lymow-card
- Owner: randrcomputers
- Created: 2026-07-18T16:06:48.000Z (7 days ago)
- Default Branch: main
- Last Pushed: 2026-07-18T19:30:59.000Z (6 days ago)
- Last Synced: 2026-07-18T21:24:05.243Z (6 days ago)
- Language: JavaScript
- Size: 1 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Lymow Card
Lovelace card built for the **[Lymow-HA](https://github.com/d3dfantasy99/Lymow-HA)** integration — a tailored dashboard for **Lymow One Plus** and other Lymow mowers, with live map, battery, session progress, mow pattern control, and Lymow-branded styling.
Replaces generic cards like [compact-lawn-mower-card](https://github.com/Tra1n84/compact-lawn-mower-card) with entity wiring and UI specific to Lymow.
## Features
- **Lymow device picker** — auto-fills mower, status, battery, map camera, buttons, and more
- **Live map hero** — integration map camera while mowing / returning (refreshes on an interval)
- **Custom artwork** — transparent generic dock / empty-dock cutouts
- **Built-in silhouette** — Lymow-style SVG fallback when no images are configured
- **Battery + online** — compact header with charging state
- **Session progress bar** — uses `Session Progress` sensor during active runs
- **Stats row** — mowed area, blade height, RTK fix
- **Smart actions** — Start / Resume / Pause / Dock via `lawn_mower` services; Cancel task & Dock & cancel via integration buttons
- **Zone picker** — choose one or more map zones before Start (`lymow.start_zones`); **All** runs the full map (`lawn_mower.start_mowing`)
- **Mow pattern** — dropdown wired to the integration **Mow Mode** select
- **Alert chips** — error, lifted, rain delay
## Install
1. Copy `lymow-card.js` to `config/www/` **or** add this repo in HACS → **Frontend** → **Custom repositories**
2. **Settings** → **Dashboards** → **Resources** → add `/local/lymow-card.js` (module)
3. Reload resources and hard-refresh the browser (**Ctrl+F5**)
### HACS custom repository
```
https://github.com/randrcomputers/ha-lymow-card
```
Category: **Lovelace**
## Quick start
Pick your **Lymow device** in the card editor (recommended):
```yaml
type: custom:lymow-card
device: YOUR_DEVICE_ID
```
Or YAML with manual entities:
```yaml
type: custom:lymow-card
entity_mower: lawn_mower.lymow_one_plus
entity_map: camera.lymow_one_plus_map
```
See `examples/dashboard-card.yaml` for a full snippet.
## Card options
| Option | Default | Description |
| --- | --- | --- |
| **Lymow device** | — | Auto-wires entities from [Lymow-HA](https://github.com/d3dfantasy99/Lymow-HA) |
| **Hero area layout** | `auto` | `auto` = map while active, art when docked; or force `map` / `art` |
| **Show map camera** | on | Uses integration **Map** camera in the hero area |
| **Show stats row** | on | Area, blade height, RTK |
| **Show mow pattern selector** | on | Integration **Mow Mode** select |
| **Show zone picker** | on | Zone chips when docked (requires Map GeoJSON sensor) |
| **Show secondary actions** | on | Cancel task, Dock & cancel buttons |
| **Mower image URL** | empty dock | Shown while mowing (`lymow_dock_empty.png`) |
| **Dock image URL** | docked photo | Shown while docked/charging (`lymow_docked.png`) |
| **Map refresh interval** | 30 s | How often to refresh the map snapshot |
## Entity wiring (auto from device)
| Integration entity | Card use |
| --- | --- |
| Lawn mower | Start / Pause / Dock |
| Status | Status pill text |
| Battery | Header gauge |
| Session Progress | Progress bar |
| Session Mowed Area | Stats |
| Blade Height | Stats |
| RTK GPS | Stats |
| Map (camera) | Hero map |
| Map GeoJSON (sensor) | Zone list for Start |
| Mow Mode (select) | Pattern dropdown |
| Online | Cloud indicator |
| Error / Lifted / Rain delay | Alert chips |
| Cancel Task / Dock & Cancel | Secondary buttons |
## Optional artwork
Copy photos to `config/www/lymow_card/` and set URLs in the editor. Details in [`lymow_card/README.md`](lymow_card/README.md).
## Troubleshooting
### Artwork not showing
1. **Copy PNGs to HA** — HACS only installs `lymow-card.js`. You must copy `lymow_card/` to `config/www/lymow_card/` (same as your File Editor path `homeassistant/www/lymow_card/`).
2. **Set paths in the card** (or rely on defaults after card v1.0.1+):
```yaml
type: custom:lymow-card
device: YOUR_DEVICE_ID
hero_mode: art
image_dock: /local/lymow_card/lymow_docked.png
image_mower: /local/lymow_card/lymow_dock_empty.png
```
3. **Verify in browser** — open `https://YOUR-HA:8123/local/lymow_card/lymow_docked.png` while logged in. If that 404s, the files are not in `www/`.
4. **Reload the card** — **Settings → Dashboards → Resources → Reload**, then **Ctrl+F5**.
5. **`hero_mode: auto`** shows the **map camera** while mowing (not the PNGs). Use `hero_mode: art` to always use dock artwork.
### Map hero blank but docked art works
The integration **Map** camera may be empty on first poll. The card falls back to PNG artwork when the map fails to load.
### Zone picker empty or missing
1. Confirm the integration exposes a **Map GeoJSON** sensor (`*_map_geojson`) — the card auto-wires it from your Lymow device.
2. Open the sensor in **Developer tools → States** and check `geojson.features` (or `geojson_zones.features`) includes entries with `properties.type: zone`.
3. **Start all** (no chips selected, or tap **All**) calls `lawn_mower.start_mowing`. Selected zones call `lymow.start_zones` (requires Lymow-HA with that service).
4. Hide the picker with `show_zone_picker: false` if you only ever mow the full map.
## Requirements
- Home Assistant **2024.1+**
- [Lymow-HA](https://github.com/d3dfantasy99/Lymow-HA) integration installed and configured
## Related
- [Lymow-HA integration](https://github.com/d3dfantasy99/Lymow-HA)
- [Pool Cleaner Card](../ha-pool-cleaner-card) — same card family for Maytronics Dolphin