{"id":49887741,"url":"https://github.com/randrcomputers/ha-pool-cleaner-card","last_synced_at":"2026-05-30T03:01:20.959Z","repository":{"id":360049887,"uuid":"1240312589","full_name":"randrcomputers/ha-pool-cleaner-card","owner":"randrcomputers","description":"Pool Cleaner card for home assistant","archived":false,"fork":false,"pushed_at":"2026-05-24T19:04:28.000Z","size":1511,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T20:23:01.659Z","etag":null,"topics":["assistant","card","dashboard","dolphin","home","maytronics"],"latest_commit_sha":null,"homepage":"https://www.randrcomputers.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/randrcomputers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-16T01:59:51.000Z","updated_at":"2026-05-24T19:04:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/randrcomputers/ha-pool-cleaner-card","commit_stats":null,"previous_names":["randrcomputers/ha-pool-cleaner-card"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/randrcomputers/ha-pool-cleaner-card","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randrcomputers%2Fha-pool-cleaner-card","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randrcomputers%2Fha-pool-cleaner-card/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randrcomputers%2Fha-pool-cleaner-card/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randrcomputers%2Fha-pool-cleaner-card/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/randrcomputers","download_url":"https://codeload.github.com/randrcomputers/ha-pool-cleaner-card/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/randrcomputers%2Fha-pool-cleaner-card/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33678271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assistant","card","dashboard","dolphin","home","maytronics"],"created_at":"2026-05-15T19:01:05.189Z","updated_at":"2026-05-30T03:01:20.953Z","avatar_url":"https://github.com/randrcomputers.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pool Cleaner Card\r\n\r\nLovelace card for the **[Maytronics Dolphin](https://github.com/randrcomputers/ha-maytronics-dolphin)** integration — power toggle, status, BLE icon, optional blue LED pulse on your robot artwork, and PSU button ring — using images from **`/local/`**.\r\n\r\n## Previews\r\n\r\n| Cleaner (cleaning) | Power supply / idle |\r\n| :---: | :---: |\r\n| ![Cleaner preview](media/preview-cleaner.gif) | ![Power supply preview](media/preview-power-supply.gif) |\r\n\r\nYour own card images (`robot` / `psu` URLs in the editor) can be **PNG, JPEG, WebP**, or **GIF** if you prefer.\r\n\r\n## Install\r\n\r\n1. **HACS** → **Frontend** → **Custom repositories** → add `https://github.com/randrcomputers/ha-pool-cleaner-card`\r\n2. **Frontend** → **Pool Cleaner Card** → **Download**\r\n3. **Settings** → **Dashboards** → **⋮** → **Reload resources**, then refresh the browser (**Ctrl+F5**)\r\n\r\n## Pictures on Home Assistant\r\n\r\nOptional artwork shipped in this repo: copy the files from **`pool_card/`** into **`config/www/pool_card/`** on Home Assistant.\r\n\r\n| File to copy (`pool_card/` → `www/pool_card/`) | Example URL |\r\n| --- | --- |\r\n| `robot_triton_front.png` | `/local/pool_card/robot_triton_front.png` |\r\n| `psu_front.png` | `/local/pool_card/psu_front.png` |\r\n\r\nEnter those URLs in **Robot image URL** / **Power supply image URL**, or YAML:\r\n\r\n```yaml\r\ntype: custom:pool-cleaner-card\r\ndevice: YOUR_DEVICE_ID\r\nimage_robot: /local/pool_card/robot_triton_front.png\r\nimage_psu: /local/pool_card/psu_front.png\r\n```\r\n\r\nUse your own images if you prefer (PNG, JPEG, WebP, or GIF paths work).\r\nUse the UI and pick your **Dolphin device**, or YAML:\r\n\r\n```yaml\r\ntype: custom:pool-cleaner-card\r\ndevice: YOUR_DEVICE_ID\r\n```\r\n\r\n---\r\n\r\n**Requirements:** Home Assistant 2024.1+ and the Maytronics Dolphin BLE integration (**v0.7.4+** for reliable **Working status** on models where `fffc` GetStatus is empty).\r\n\r\n### Card entity wiring\r\n\r\n| Field | Use |\r\n| --- | --- |\r\n| **Dolphin device** | Recommended — auto-fills Power, Cleaner state, Working status |\r\n| **Cleaner state** | Keep as **Cleaner state** (do not swap for Clean program) |\r\n| **Working status** | Leave empty if device is set; card needs `at_work` / `finished` (v0.7.4 infers this when GetStatus is missing) |\r\n| **Cleaning active** | Optional — ignored for the status pill (too broad after a cycle) |\r\n| **Clean program** | Not used by this card |\r\n\r\n## Status pill (not just “power on”)\r\n\r\nThe card uses **Cleaner state** plus **Working status** (from the integration’s `GetStatusRead` poll, or the `working_status` attribute on **Cleaning surface**):\r\n\r\n| What you see | Meaning |\r\n| --- | --- |\r\n| **Cleaning** | Robot reports `at_work` — bubbles, robot image, green pulsing dot |\r\n| **Done cleaning** | Cycle finished (`finished`) or cleaner state **hold** |\r\n| **Powered on** | Power/PS still on but not actively cleaning (avoids false “Running”) |\r\n| **Off** | Cleaner state off |\r\n| **Programming** / **Self test** / **Fault** | Matching robot modes |\r\n\r\nPower button still reflects the **Power** switch. Robot artwork and LED overlay only appear while status is **Cleaning** (unless you set *Robot vs power supply image* to Always/Never in card options).\r\n\r\n## Schedule (Home Assistant — not the phone app)\r\n\r\nThe card can drive a **simple HA schedule**: pick **days**, **start time**, and **1 h / 2 h** run length. Home Assistant turns the cleaner **on**, waits, then **off** — no MyDolphin APK schedule needed.\r\n\r\n### One-time setup\r\n\r\n1. Copy **`examples/pool-cleaner-schedule.yaml`** into your HA config (or merge into `configuration.yaml`).\r\n2. Replace **`switch.YOUR_POWER_SWITCH`** in the automation with your Dolphin **Power** entity.\r\n3. **Developer tools → YAML → Reload** input helpers, scripts, and automations (or restart HA).\r\n4. Edit the **Pool Cleaner Card** → enable **Show schedule panel** and map:\r\n   - `input_boolean.pool_cleaner_schedule_enabled`\r\n   - `input_datetime.pool_cleaner_schedule_time`\r\n   - `input_select.pool_cleaner_schedule_duration`\r\n   - `input_text.pool_cleaner_schedule_days`\r\n   - `script.pool_cleaner_timed_run`\r\n5. Reload dashboard resources (**Ctrl+F5**).\r\n\r\n### On the card\r\n\r\n| Control | What it does |\r\n| --- | --- |\r\n| **Schedule On/Off** | Enables the daily automation |\r\n| **Start** | Time of day to start (local time) |\r\n| **Run 1 h / 2 h** | How long power stays on before auto-off |\r\n| **Days** | M–S toggles (0=Monday … 6=Sunday) |\r\n| **Run 1 h / Run 2 h (Now)** | Start immediately; auto-off after duration |\r\n\r\nScheduling runs **in Home Assistant** (automation + script), so it works even when nobody has the dashboard open.\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandrcomputers%2Fha-pool-cleaner-card","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frandrcomputers%2Fha-pool-cleaner-card","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandrcomputers%2Fha-pool-cleaner-card/lists"}