Skip to content

Breaking Change on mode name normal. Now the automatic mode is called 'automagical'

Choose a tag to compare

@Pythm Pythm released this 22 Feb 21:21
bd6e8e9

🚨 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.json file has been updated but remains backwards compatible. The old key normal is still present, so existing translations continue to work. New users should use the new key automagical when 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_control option
  • 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_control is 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_lights scheduling when multiple automations/motion lights are configured at the same time
  • Fixed and improved dim rate calculations
  • Updated input_select exclusions 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_control enabled
  • Configure room types in your app settings to enable the new behavior