Thread Pulse 1.6.0

Added

• Section Connected systems in the detail panel: how many and which systems (Matter fabrics) can control the device, e.g. Apple Keychain and Home Assistant · this Home Assistant. The number comes from the cached diagnostics; the list is loaded from matter/node_diagnostics only when the panel is opened, once per device (#79)
• Firmware overview: badge ↑ on devices with a firmware update available in Home Assistant (… while one is installed; skipped updates get no badge), row Update in the detail panel (up to date / available / skipped / installing with percentage), and a section Firmware in the list with pending updates and models whose devices run different firmware versions. Checked every minute; installing stays in Home Assistant. Changes of update entities are no longer animated as messages from the device (#81)
• The change log is stored in Home Assistant per user (frontend/set_user_data) instead of per browser: the same list on every device, synchronised live between open pages, up to 200 entries. The same change noticed by several open pages is kept once; Clear list applies to all devices. Entries stored in the browser by older versions are moved to Home Assistant on first use; if Home Assistant refuses, the browser is used as before (#86)
• Text report for forums and issues: ⋯ → 📝 Text report for forums … opens a Markdown summary of the mesh – Thread Pulse and Home Assistant version, devices by role, border routers, channel, and per device area, model, firmware, role and connection (parent and signal, or router links), weak links between routers, warnings and hints. Shown before copying; anonymised by default with the same numbering as the anonymised image. Never contains the network key, network name, PAN IDs or addresses (#85)
• Mesh health: one grade (A–E) for the whole mesh with its six factors – routers, redundancy (routers with fewer than two good router links), weak parent signal, hops to the border router, devices per router, stability. Each factor is ok / check / problem with its value and the affected devices; check counts 1 point, problem 2. Shown in the list, the border router panel and the text report; factors that cannot be judged (e.g. without a known border router) are marked and the grade says so. Grade changes go to the change log once two checks in a row agree (#84)
• Trends in the detail panel: small charts of the last 7 days with the value of each hour on hover or tap. Battery level from Home Assistant's long-term statistics (hourly mean). Signal – to the parent, for routers the best link to another router – recorded by Thread Pulse at every load and check while a page is open, averaged per hour and stored in Home Assistant per user (thread_pulse_signal, at most every 15 minutes; browser as fallback), so an always-open wall tablet fills the history for every device. Hours without an open page are gaps in the line, and the note says how many hours are covered (#38)
• If this router fails in the panel of every router (except the border router): devices that use it as parent – mains devices with another router in reach are shown with it (can switch to …), for battery devices this is unknown and said so – and routers that would be cut off from the border router (graph of router-to-router links), with their devices. Show affected devices on the map marks them. The tab Links ranks the routers by how many devices depend on them. Worded as an estimate – Thread repairs itself (#77)

Changed

• Tidier toolbar in one row: search, ⏸ Live, ≋ Traffic, ⌂ Rooms, 📊 Network (see below) and a ⋯ menu with Reload, Sound (with volume), Export (image with names, anonymised image, text report – replaces the button 📷 Image) and the version. The legend opens with ? on the map and starts hidden. Buttons that switch something on are highlighted. On narrow cards and phones the buttons show icons only and the search is an icon that widens when used. The status line is shorter (no version; Tap a device for details only until a device was opened); tapping it reloads (#107)
• The list below the map is now a network panel with tabs, opened with 📊 Network (was ☰ Show list; the badge counts warnings and hints): Overview (mesh health grade with only the factors to check, the others folded; the three most important points), Hints (all warnings and hints, warnings first), Devices (one table with role, parent or router links, signal and firmware – sortable, filter by role; replaces the table of battery devices; the firmware overview below it), Links (weak router links and weak parent signals), Changes (with the number of new entries since last viewed). Tapping a factor or a link marks its devices on the map (n marked · Show all). The chosen tab is remembered (#108)
• Maintenance after enabling CodeQL code scanning: the Validate workflow runs with a read-only token, line breaks in router names are replaced completely in the panel title. The two warnings in the unmodified graph library (vis-network) are dismissed with a documented reason (#94)

Install / update

• HACS: Thread Pulse shows the update to 1.6.0 – install it and reload the browser. New installation: HACS → ⋮ → Custom repositories → https://github.com/riticulus/ha-thread-pulse, type Dashboard.
• Manual card: download Source code (zip) below, copy dist/ha-thread-pulse.js and dist/thread-pulse-vis-network.js to /config/www/.
• Standalone page: from Source code (zip), copy dist/thread-pulse.html and dist/thread-pulse-vis-network.js to /config/www/ and raise ?v= in the card URL.

See the user guide and the changelog.

Thread Pulse 1.5.2

Fixed

• Two devices that report the same hardware address (e.g. two Aqara P2 motion sensors – a firmware quirk) no longer stop the whole map with Cannot add item: item with id … already exists. They get unique ids on the map (address plus Home Assistant device ID) and a hint; their link to the parent is shown, links reported by other devices may be missing. A duplicate id can no longer empty the map in general (#98)

Install / update

• HACS: Thread Pulse shows the update to 1.5.2 – install it and reload the browser. New installation: HACS → ⋮ → Custom repositories → https://github.com/riticulus/ha-thread-pulse, type Dashboard.
• Manual card: download Source code (zip) below, copy dist/ha-thread-pulse.js and dist/thread-pulse-vis-network.js to /config/www/.
• Standalone page: from Source code (zip), copy dist/thread-pulse.html and dist/thread-pulse-vis-network.js to /config/www/ and raise ?v= in the card URL.

See the user guide and the changelog.

Thread Pulse 1.5.1

Fixed

• Border routers of other systems are labelled with the name they announce (e.g. HomePod Salon) instead of the model: Apple announces the same model BorderRouter for all its border routers, so they could not be told apart. The model is only used when it is not generic; very long names are shortened; the anonymised image shows Border router (#71)
• Names of border routers that arrive after the map is drawn (the discovery answers a few seconds later) now also reach the list (talks through, weak links), the hints and the detail panels of their children – they showed …7114 before (#71)

Thanks to @oxmo75 for testing 1.5.0 on a real Apple-only network and for the analysis.

Install / update

• HACS: Thread Pulse shows the update to 1.5.1 – install it and reload the browser. New installation: HACS → ⋮ → Custom repositories → https://github.com/riticulus/ha-thread-pulse, type Dashboard.
• Manual card: download Source code (zip) below, copy dist/ha-thread-pulse.js and dist/thread-pulse-vis-network.js to /config/www/.
• Standalone page: from Source code (zip), copy dist/thread-pulse.html and dist/thread-pulse-vis-network.js to /config/www/ and raise ?v= in the card URL.

See the user guide and the changelog.

Thread Pulse 1.5.0

Added

• Border routers of other systems (Apple TV, HomePod, Google Nest, Amazon Echo …) are named on the map, e.g. HomePod mini · Border router …7114, using Home Assistant's border router discovery (thread/discover_routers, matched by extended address, in the background while the page is open); their panel shows manufacturer, model, name, Thread version and network and whether Home Assistant uses them. The panel of Home Assistant's border router also shows manufacturer, model, name and Thread version. The anonymised image shows only the model (#37)
• Networks without a known border router (no OpenThread Border Router add-on, e.g. Apple or Google border routers only, possibly no Matter router at all): the parent router of every device is taken from the device's own neighbour table and shown as other Thread router …xxxx, and messages are animated over this first hop (device ↔ parent); its panel counts the messages and explains that the way from there to Home Assistant is unknown. Parents that are not Matter devices now always appear on the map. New demo ?demo=apple. Thanks to @oxmo75 for the analysis and the patch (#71)
• 💡 Identify button in the detail panel of Thread and Wi-Fi devices that have an identify button in Home Assistant (Matter Identify cluster): the device blinks, beeps or flashes for a few seconds. Clearly marked as a real command, locked for 4 s after pressing, feedback in the panel; battery devices get a note that they react only when they wake up. The command is animated like any other (#4)
• Automation blueprint Thread Pulse: device offline notification (blueprints/automation/thread-device-offline.yaml, import button in the README): notifies when a selected Matter device has been unavailable for a delay (default 5 min), optionally when it is back (with the duration) and in the Home Assistant notifications; any notify action, own texts with placeholders. Runs in Home Assistant in the background, unlike the change log (#42)
• Save the map as an image: button 📷 Image in the toolbar, with names or anonymised (devices Device 1, 2 … numbered by position on the map, rooms Room A, B …, no address suffixes). The PNG shows the map as it is on screen (zoom, links, badges, room areas, traffic, messages) on the page background, with a line for version, date and number of devices; file name thread-pulse-<date>.png / …-anonymised.png. On phones and tablets the share sheet opens where available (#40)

Changed

• The user guide now lives in the repository (docs/wiki/) and is published to the wiki after every release by the GitHub action Release (by hand: action Wiki), so documentation changes are reviewed in the same pull request as the code and the wiki always describes the latest release. tools/wiki.py checks every page link and image (also in CI) and publishes the pages; the wiki shows a note that it is generated (#54)
• Release automation: tools/release.py prepares a release (prepare X.Y.Z: version, changelog section, links, build), switches back to the development version (dev), checks a release (check) and writes the release notes (notes); the GitHub action Release creates the GitHub release when a tag vX.Y.Z is pushed – only after checking version, changelog and generated files, and never with attachments. Started by hand it is a dry run (#53)
• Browser tests in the repository (tests/): smoke_test.py clicks through every feature in demo mode and fails on any JavaScript error, visual_test.py checks centering and double-click with pixel analysis, browser.py is a small helper for headless Chrome (no Selenium / Playwright); how to run them in tests/README.md (#48)
• The standalone page is now generated into dist/thread-pulse.html, next to the graph library; the duplicate copies at the top level of the repository are removed. Manual installation of the standalone page: take thread-pulse.html and thread-pulse-vis-network.js from the dist folder of Source code (zip). Existing installations are not affected (#47)
• Code tidy-ups without change in behaviour: the device panel uses the shared live rows, deName() renamed to localName(), icon data moved to src/icons.js, colours defined once in COLORS (the CSS gets them as variables) (#51)
• Settings remembered by the browser are handled in one place (src/prefs.js: keys, types, defaults). Same storage keys and formats as before – existing settings keep working; safe when storage is blocked (#50)

Fixed

• Pressing a button entity (e.g. Identify) no longer shows up as a message from the device and is no longer counted as a response time of about 0 ms – a button's state is the time of the press, set by Home Assistant itself

Install / update

• HACS: Thread Pulse shows the update to 1.5.0 – install it and reload the browser. New installation: HACS → ⋮ → Custom repositories → https://github.com/riticulus/ha-thread-pulse, type Dashboard.
• Manual card: download Source code (zip) below, copy dist/ha-thread-pulse.js and dist/thread-pulse-vis-network.js to /config/www/.
• Standalone page: from Source code (zip), copy dist/thread-pulse.html and dist/thread-pulse-vis-network.js to /config/www/ and raise ?v= in the card URL.

See the user guide and the changelog.

Thread Pulse 1.4.0

Added

• Matter devices on Wi-Fi or Ethernet: shown as their own group in a column to the right of the mesh (heading, legend entry, grey-blue), without links and without path animation (their messages are counted); detail panel with live counter, current values, Wi-Fi signal, channel and standard, restarts and device data; found by the search; stay in their column in the room view; hide them with the card option show_wifi: false or ?nowifi (#43)
• Battery forecast in the detail panel, e.g. empty in about 10 months · based on 46 days, −3.7 % per month: linear trend of the daily battery level from Home Assistant's long-term statistics (up to 120 days, only since the last battery change); needs at least 14 days and a measurable drop; hint and i badge when the battery will probably be empty within 30 days. It is an estimate – many batteries stay almost full for a long time and then drop quickly (#39)
• French, Italian, Spanish and Dutch: all texts, plus translations of common English entity names (e.g. Active current, Voltage) in the ticker and the detail panel; chosen from the Home Assistant profile, card option language (fr, it, es, nl) or ?lang=. The translations have not been checked by native speakers yet – corrections are welcome (#44)
• Detail panel for the border router: Thread network (name, channel, PAN ID, extended PAN ID, routers in the mesh, devices, leader), border router (type, address, border agent ID, known Thread networks), neighbours and children, messages through it; other Thread routers get a panel with their neighbours. The network key is never shown (#36)
• Optional sound: a short, quiet tick for every animated message – high for messages to Home Assistant, low for commands; button "🔇 Sound" in the toolbar and a volume slider, both remembered by the browser; off by default; rate-limited (at least 150 ms apart, at most 5 per second); silent while live is paused (#12)
• Ambient mode for wall tablets: card option ambient: true or ?ambient – only the pulsing mesh on a fixed dark background, no toolbar, legend, list or ticker; slow automatic zoom to a router and back every 25 s (ambient_motion: false / &still to switch off, paused for 60 s after touching the screen); the detail panel closes by itself after 15 s; asks the browser to keep the screen on where possible (#11)
• Double-click / double-tap: on empty space the whole mesh is centered and fitted to the map area, on a device the map zooms to it (centered in the part not covered by the detail panel); the browser's page zoom no longer triggers inside the map (#23)

Changed

• Issue forms for bug reports, feature requests and translation corrections, a pull-request template, a Contributing section in the README and a clear label scheme (bug, New Feature, enhancement, documentation, translation) (#52)
• Translations split into one file per language in src/i18n/; build.py collects all language files automatically; new check tests/check-i18n.js (also run in CI) makes sure every language has the same keys as English. No change in behaviour – all texts and translations are identical in content (#49)
• Source split into one file per topic in src/ (version.js, styles.css, markup.html, core.js, one file per feature, ui.js, start.js); build.py assembles them in a fixed order. No change in behaviour – the generated files contain exactly the same lines as before (#33)

Install / update

• HACS: Thread Pulse shows the update to 1.4.0 – install it and reload the browser. New installation: HACS → ⋮ → Custom repositories → https://github.com/riticulus/ha-thread-pulse, type Dashboard.
• Manual card: download Source code (zip) below, copy dist/ha-thread-pulse.js and dist/thread-pulse-vis-network.js to /config/www/.
• Standalone page: from Source code (zip), copy thread-pulse.html and thread-pulse-vis-network.js to /config/www/ and raise ?v= in the card URL.

The French, Italian, Spanish and Dutch texts have not been checked by native speakers yet – corrections are welcome (Translation correction in the issue forms).

See the user guide.

Thread Pulse 1.3.0

Added

• Change log: the network is checked every 5 minutes (map positions are kept) and changes are listed with time stamps – devices new / gone, reachable / not reachable (live), new parent, signal to the parent changing quality, role changes, usable router links appearing / lost; the affected device flashes on the map; the list is kept in the browser (#7)
• Response time per device: time from a command in Home Assistant until the device confirms it (Home Assistant time stamps, matched by context); shown in the detail panel (last / median / number of measurements) and in the live ticker; hint for devices that respond slowly (median ≥ 1 s over at least 3 commands) (#2)
• Room view: button "⌂ Rooms" arranges the devices by Home Assistant area – every room gets its own spot with a coloured area and its name, the border router and devices without an area share one spot; links between rooms stay visible (#8)
• Search box: find devices by name or area (case and accents ignored); matches are selected and zoomed to, the rest fades out; Enter opens the first match, Esc clears (#9)

Changed

• Releases no longer carry a zip attachment (HACS would download the attachment instead of the card); manual installation uses Source code (zip) of the release

Fixed

• Switching the room view off left the mesh off-center and too small: the devices now glide back to their positions from before the room view and the map is fitted afterwards; if the room view was already on when the page was loaded, the layout is calculated completely before fitting (#22)

Install / update

• HACS: Thread Pulse shows the update to 1.3.0 – install it and reload the browser. New installation: HACS → ⋮ → Custom repositories → https://github.com/riticulus/ha-thread-pulse, type Dashboard.
• Manual card: download Source code (zip) below, copy dist/ha-thread-pulse.js and dist/thread-pulse-vis-network.js to /config/www/.
• Standalone page: from Source code (zip), copy thread-pulse.html and thread-pulse-vis-network.js to /config/www/ and raise ?v= in the card URL.

See the README.

Thread Pulse 1.2.0

Added

• Dashboard card custom:thread-pulse-card, installable with HACS (custom repository, type Dashboard) or manually; options height, language, demo in the visual card editor; the graph library is only loaded when a card is shown (#13)
• GitHub action: HACS validation and a check that the generated files match src/
• Weak-spot hints: rules of thumb that point out weak parent signals (below −80 dBm), unstable connections with likely causes, routers that probably lose power regularly (≥ 50 restarts, e.g. a bulb on a wall switch) and routers at the edge of the mesh; shown in the detail panel, at the top of the list (count on the list button) and as a small "i" badge on the map (#10)
• Traffic heat: links glow wider and brighter the more messages travelled over them in the last 10 minutes (estimate based on the computed paths); toggle button "≋ Traffic", legend entry, link tooltip with the message count (#3)
• Detail panel of routers shows how many messages they forwarded for other devices (last 10 min / last hour) (#3)

Changed

• Code moved to src/ (shared core for page and card); build.py generates thread-pulse.html and dist/ (#13)
• Detail panel switches to the bottom-sheet layout based on the width of the map instead of the window
• German translation for "Effective voltage"
• German labels "Letzte Minute" / "Letzte Stunde" capitalised

Install / update

• HACS (new): HACS → ⋮ → Custom repositories → https://github.com/riticulus/ha-thread-pulse, type Dashboard → download Thread Pulse → add the card Thread Pulse to a dashboard.
• Manual card: download Source code (zip) below, copy dist/ha-thread-pulse.js and dist/thread-pulse-vis-network.js to /config/www/ and add /local/ha-thread-pulse.js as a JavaScript module resource.
• Standalone page: from Source code (zip), copy thread-pulse.html and thread-pulse-vis-network.js to /config/www/ and raise ?v= in the card URL.

See the README.

Thread Pulse 1.0.0

Added

• Detail panel: tap or click a device to see manufacturer, model, firmware, hardware, area, Thread role, parent and neighbours with signal strength, battery level and type, current values with "last changed", stability counters (restarts, last restart reason, drop-offs, attach attempts, parent changes) and a button to open the device in Home Assistant (#1)
• Badges on the map: battery level on battery devices, warning sign on devices that look unstable (≥ 5 attach attempts or ≥ 3 drop-offs since restart) or have a battery below 20 % (#1)
• Live message counters per device since the page was opened (#1)
• Demo mode shows invented device details, battery levels and current values
• Version number at the end of the status line

Changed

• Installation instructions point to the release downloads

Install / update: download thread-pulse-1.0.0.zip, copy both files to /config/www/ and raise ?v= in the card URL. See the README.

Thread Pulse 0.1.0

Added

• Interactive map of the Matter-over-Thread mesh: routers, mains and battery end devices, border router, links coloured by signal strength
• Live animation of messages to and from Home Assistant along the most likely route, with a ticker
• Optional table of battery devices and their parents and of weak router links
• Icons chosen from the device's entities, English and German texts, Home Assistant theme support
• Demo mode (?demo) that works without Home Assistant
• Readable (unminified) vis-network build

Install / update: download thread-pulse-0.1.0.zip, copy both files to /config/www/ and raise ?v= in the card URL. See the README.