Repository navigation
Releases
v1.13.0
Home Assistant-wide animation default with a per-device override (#9). Create a Toggle helper input_boolean.canvas_ribbons and switch it off: no device starts the canvas, the animation loop or the theme override, not even on first load. A powerful device opts back in with Animation on this device -> On in the settings panel. Devices that ask for reduced motion start with the animation off. Without the helper nothing changes. See the README section Turning the animation off for all devices.
v1.12.2
Fix: full theme mode now also switches the text tokens (primary, secondary, disabled, outline, input fill) to the dark-theme values when the active HA theme is a light one. Before, only the header and sidebar text was switched, so cards, dialogs and lists showed the theme's dark text on the plugin's dark glass. The override follows theme switches without a reload. New JSDOM tests in theme.test.js.
v1.12.1: readable header and sidebar with a light theme
Fixed
- Header and sidebar readable with a light theme. Full theme mode makes the top bar and the sidebar dark (
rgba(32,33,36,…)) but left their text colour to the active theme. With a light theme, such as the default one, that was dark text on a dark bar: the view tabs and the sidebar entries were practically invisible. Full mode now also sets light header text, header selection bar, sidebar text and sidebar icons. Canvas-only mode is unchanged: it leaves those surfaces to your theme.
v1.12.0: every slider applies live
Fixed
- Every slider applies live again (#7). Speed min/max were stored but the running ribbons kept the speed they were created with until a page reload; wave count and performance mode needed a reload too, and a shorter trail never shrank. All of them now apply while you drag, also when a preset or the auto-sun preset changes them. The "refresh page" hints are gone.
- In canvas-only theme mode the card/header/sidebar alpha sliders are greyed out: that mode leaves those surfaces to your theme (e.g. Material You), so the sliders have nothing to act on.
Changed
- Hidden button (#8):
?canvas-ribbons=settingsnow also opens the settings when HA navigates in-app, not only on a full page load. In the Companion app add a button card withtap_action: navigateto/lovelace/0?canvas-ribbons=settings(see README, Hidden button).
v1.11.1: repository renamed to hassio-canvas-ribbons
Repository renamed
This repository is now jrx-code/hassio-canvas-ribbons (was ha-canvas-ribbons). GitHub redirects the old address, and the card itself is unchanged.
HACS installs into a folder named after the repository, so after this update it adds a new dashboard resource /hacsfiles/hassio-canvas-ribbons/ha-canvas-ribbons.js next to the old /hacsfiles/ha-canvas-ribbons/... one. With both loaded the card breaks. After updating:
- Settings → Dashboards → Resources: delete the entry starting with
/hacsfiles/ha-canvas-ribbons/ - Delete the folder
/config/www/community/ha-canvas-ribbons/ - Refresh the browser (Ctrl+Shift+R)
Your ribbon settings are kept: they are stored in the browser under the same keys as before.
Installation
Download ha-canvas-ribbons.js below and place it in your HA /config/www/ directory, or update via HACS.
v1.11.0: Canvas-only theme mode, Firefox performance mode
What's new
Theme mode: canvas only (fixes #4)
New Theme override option. Full (cards + header) keeps the previous behaviour; Canvas only draws the ribbons but leaves card and header colours to your theme, so Material You and other themes that style cards keep working.
Performance mode (for #3)
New Performance option: Auto, High, Low. Low caps the device pixel ratio and draws every other frame while keeping the same ribbon speed, trail length and colour cycle. Auto picks Low on Firefox. Changing the mode needs a page reload.
Translations
New labels in all 6 languages (EN, PL, DE, ES, CA, CS).
Installation
Download ha-canvas-ribbons.js below and place it in your HA /config/www/ directory, or update via HACS.
Changelog
v1.10.0 — Configurable button position
What's new
Configurable button position (fixes #1)
The floating settings button can now be moved to any corner or hidden entirely.
Options:
- Bottom-right (default)
- Bottom-left
- Top-right
- Top-left
- Hidden (access panel via
?canvas-ribbons=settingsURL parameter)
The selected position persists across page reloads via localStorage. The "Reset" button restores the default position.
This resolves the overlap issues with HA system buttons, Navbar cards, and other UI elements reported in #1.
All translations updated
Button position labels available in all 6 supported languages (EN, PL, DE, ES, CA, CS).
Installation
Download ha-canvas-ribbons.js below and place it in your HA /config/www/ directory, or update via HACS.
Changelog
9d471fefeat: configurable button position, bump to v1.10.01884dadfeat: add Catalan (ca) translation (v1.9.0)
v1.9.0 — Catalan translation
What's new
Catalan (ca) translation
Full Catalan locale for the settings panel UI. Canvas Ribbons now supports 6 languages: English, Polish, German, Spanish, Catalan, and Czech.
Supported languages
| Code | Language |
|---|---|
| en | English |
| pl | Polski |
| de | Deutsch |
| es | Español |
| ca | Català (new) |
| cs | Čeština |
Installation
Download ha-canvas-ribbons.js below and place it in your HA /config/www/ directory, or install via HACS (custom repository).
Full changelog
1884dadfeat: add Catalan (ca) translation, bump to v1.9.0
v1.8.0
Auto-preset based on sun position
- Auto (sun) toggle in GUI — automatically switches daytime presets based on sun elevation
- Configurable sun entity (default:
sun.sun) - Maps elevation + rising direction to presets: Night, Dawn, Sunset, Noon
- Shows current phase and elevation in GUI
- Polls every 60 seconds via
hass.states - Manual slider change disables auto-sun mode
- Translations for all 5 languages (EN, PL, DE, ES, CS)