All notable changes to this project will be documented in this file. The format is based on Keep a Changelog.
- More translations.
- Adding more calculated attributes in the sensor section.
- Adding card information about sun and alignement position.
- Turn on /off frame limit feature.
- Add multi location function, for multiple sites / houses.
- Energy HUD overlay for Solar / Home / Grid values with adaptive styling.
- Small-card
(i)interaction mode for energy HUD below300x300(tap to open/close details). - Grid flow sensor support in the card (with sign invert), including runtime precedence over roof power flow.
- Power-only sensor enforcement for roof/grid flow selection.
- Utility pole + powerline rendering with bidirectional pulse flow visuals.
- Diagnostics metadata for resolved location source, selected zone entity, and active location name.
- Location selection, with resolution, supports safe fallback to Home coordinates when a selected zone is missing/invalid. Thank you @yazck for the suggestion!
- Added Polish translation file (
pl.json) and aligned it with current config/options/service translation keys. Thank you @Adrian-czw fot the translation!
- Bumped integration/card release version to
0.2.6. - Improved wall
%label projection using roof-style affine mapping.
- Entity picker fallback behavior in visual editor power selectors.
- Multiple card visual issues for powerline/pole/cable layering, pulse direction, and occlusion.
- Wall percent-label projection consistency and anti-stretch behavior.
- Lovelace resource auto-registration hardening:
- URL normalization before duplicate checks (query/hash and legacy-equivalent path handling)
- async-only static path registration path retained (
async_register_static_paths/async_register_static_path)
- Roof power sensor persistence in setup/options:
- selected roof power sensor is no longer cleared when
Enable power labelis disabled.
- selected roof power sensor is no longer cleared when
- Fixed Sun Azimuth visual mode (sun rotation lock) with scene rotation compensation, thank you @HACS-bank for the suggestion!
- Visual editor section/label for
Fixed Sun Azimuth (sun rotation).
- Save Camera View now batches integration-backed values (
camera_rotation_h,camera_rotation_v, andfixed_sun_azimuth) in a singlesunlight_visualizer.set_optionscall to reduce flicker. - Bumped integration/card release version to
0.2.5.
- Card auto-size down by available width (
autoScaleWidth, defaulttrue) with minimum width clamp at250px. - Visual editor option under Auto‑rotate:
Auto-scale Width. - One-click HACS install badge in README.
- HACS-approved installation status documented in release notes and README.
- Bumped integration/card release version to
0.2.3. - README install instructions updated for HACS-approved flow and card auto-registration notes.
- Config flow: improved house direction/custom angle behavior and validation handling.
- Translation updates (EN/SV/ES) for clearer compass/front-door direction wording.
- Bumped integration/card release version to
0.2.2. - Finalized manifest/HACS metadata to satisfy strict validator rules used by Hassfest and HACS.
- Confirmed CI validation flow for:
- HACS validation (
.github/workflows/hacs.yaml) - Hassfest validation (
.github/workflows/hassfest.yaml)
- HACS validation (
- Resolved manifest schema and ordering issues flagged by Hassfest.
- Resolved
hacs.jsonschema mismatch flagged by HACS validation.
- Home Assistant translation files for English, Swedish, and Spanish:
custom_components/sunlight_visualizer/translations/en.jsoncustom_components/sunlight_visualizer/translations/sv.jsoncustom_components/sunlight_visualizer/translations/es.json
- GitHub Actions workflows:
- HACS validation (
.github/workflows/hacs.yaml) - Hassfest validation (
.github/workflows/hassfest.yaml)
- HACS validation (
- Card picker metadata (
window.customCards) so the card is discoverable in "Add card" UI. - Repository license file (
LICENSE, MIT).
strings.jsonexpanded with integration title + service translations forsunlight_visualizer.set_options.manifest.jsoncleaned for Home Assistant compatibility (removed non-standardtranslationsmanifest key).hacs.jsonaligned for integration packaging (domainsused; no frontend-onlyfilenameoverride).- README documentation updated for validation, translations, and install/deployment expectations.
- Major visual upgrade (
houseStyleV2) with flat-roof house styling. - Roof overhang + thickness rendering (
flatRoofEnabled,flatRoofOverhang,flatRoofThickness). - Front door and window visuals on house faces.
- Roof solar panel visuals and roof power label rendering.
- Back tree visual with camera-aware occlusion and base shadow anchoring.
- Sky enhancements: moving clouds, day/night gradient system, stars, moon, twilight transitions.
- Sunbeam flow animation and animated short sun rays around sun icon.
- On-card camera controls: manual H/V rotate, stop, save/restore view, angle readouts.
- CSS performance limiting/debug indicators for low-FPS environments.
- Floor styling improvements: grass tint, floor thickness/edge treatment, compass/tick improvements.
- Integration options for forced sun fallback and manual fallback sun azimuth/elevation.
- Integration renamed and aligned to
sunlight_visualizer/ "Sunlight Visualizer". - Card defaults updated for v2 visuals and readability tuning.
- Roof label rendering reworked for robust roof-plane projection and better readability.
- Roof/wall/floor draw ordering refined with explicit depth/tie-break rules.
- Facade dimming based on sunlight intensity improved with smoother curve controls.
- Auto-rotate adaptation/calibration improved for slow displays.
- Roof power handling updated to hide label when disabled and fallback to
0 Wwhen enabled with missing/invalid value. - Visual editor updated to drive integration-backed settings where applicable.
- Sun position visual and surface intensity mapping mismatches (including 180° inversions).
- Roof direction mapping issues (front/back and left/right alignment edge cases).
- Roof top/underside/side ordering artifacts and intermittent clipping.
- Tree bleed-through and incorrect front/back pass behavior.
- Shadow clipping artifacts and low-angle shadow inversion cases.
- Card auto-registration/resource loading behavior for HACS/custom install flows.
- Config/options flow regressions for roof power entity selection and optional behavior.
- Alignment sensor edge cases and clamping behavior for roof alignment percentage.
- Camera control interaction bugs (button behavior, state sync, label alignment).
- HACS packaging structure for integration + Lovelace card in one repository.
- Auto-registration of Lovelace card resource from integration endpoint.
- Integration-managed camera rotation entities (
House Camera Rotation H/V). - Roof power sensor selection, enable toggle, and invert option.
- Force sun fallback test mode support in integration options.
- Core integration naming and docs alignment for release readiness.
- README and installation guidance expanded for custom repo use.
- Config flow and options flow validation/selector issues.
- Startup/resource registration errors across Home Assistant versions.
- Entity creation/runtime errors tied to roof-power option fields.
- Initial v1 release.
- Sunlight intensity calculation for walls and roof.
- Base 2.5D house SVG card with sun, shadow, compass, and surface labels.
- Integration sensors/selects/numbers for house angle, roof direction, tilt, and update interval.