Breaking Change on mode name normal. Now the automatic mode is called 'automagical'
🚨 Breaking Changes
Automation Mode Rename
- To avoid further confusion about the mode name 'normal', the default automation mode name has been changed to 'automagical'.
Backwards Compatibility Note: The
translations.jsonfile has been updated but remains backwards compatible. The old keynormalis still present, so existing translations continue to work. New users should use the new keyautomagicalwhen calling the mode.
Copy out the translations.json before upgrading and point to the persistent stored file if not already done so, to avoid downtime on your 'normal' mode changes. Read more about using the translations.json file here: https://github.com/Pythm/ad-Lightwand?tab=readme-ov-file#-translating-or-changing-modes
✨ Noteworthy Changes
Manual Adjustments – Improved Feature
- Better handling of manual adjustments to lights with the new
take_manual_controloption - When enabled, prevents light changes even when motion detection until a new mode or reset is called
Note that media players are considered a new mode.
Monitoring: When Lightwand detects a manual override, it logs:
Manual Override detected for {self.lights[0]} with new brightness {self.brightness}Tip: If you experience lights not automating when
take_manual_controlis enabled, check the logs for manual override events. During testing, some lights bounced frequently and ended up at unexpected brightness when the transition was set to high.
🏠 Room Types Feature
With Lightwand v2.1.0 you can now assign a room type to your apps by configuring one of the predefined types with roomtype. The room type automatically configures a set of default options and additional behavior tailored to the particular space.
| Room Type | Default Behaviour |
|---|---|
| outdoor | • Motion sensors trigger lighting during away and night modes • Excludes the room from custom and wash modes |
| bedroom | • Excludes the room from custom and wash modes • Logic to prevent automagical mode or reset when night mode is active, unless the mode name includes the room name between 10:00:00 after morning and until 05:00:00 before the morning routine starts |
| hallway | • Motion triggers lighting during away mode |
| living‑room | • Full manual control of the lighting by default when a light is manually adjusted |
| kitchen | • Full manual control of the lighting by default when a light is manually adjusted |
Note: More advanced options will become available for each type in future releases.
🎬 Media Players
Media players are now considered on if their state is not 'off', 'idle', 'paused', 'unavailable', or 'unknown'. This allows media players reporting as "playing" or similar states to be correctly registered as 'on'.
🐛 Bug Fixes & Improvements
- Fixed duplicate
run_daily_lightsscheduling when multiple automations/motion lights are configured at the same time - Fixed and improved dim rate calculations
- Updated
input_selectexclusions to use translations for fire, false alarm, and reset options - Fixed turn on delay for automagical and morning modes
- Now sends new updates to light when motion is detected and the light has not been updated
📝 Upgrade Notes
- Existing users should see no disruption as the translation file remains backwards compatible
- Review logs if experiencing unexpected brightness changes with
take_manual_controlenabled - Configure room types in your app settings to enable the new behavior