Skip to content

Scheduling Manager v1.11.0: programmatic schedule controls

Choose a tag to compare

@flatsheep flatsheep released this 22 Oct 21:58

Programmatic schedule and time-band controls

Control schedules and bands from Home Assistant automations, scripts and API clients.

  • Every schedule and band has a native Disabled switch: on = disabled,
    off = enabled. Sub-schedules do not have enable/disable controls.
  • heating_schedule_manager.get_disabled reads a boolean state. Omit path
    to discover the current schedule and band paths.
  • heating_schedule_manager.set_disabled accepts a path and disabled: true
    or false. True disables permanently; false cancels any timed band disable.
  • Enabling an active band applies its start settings. Schedule-level disable
    and applicable Away still take precedence.
  • A disabled parent makes its bands report disabled without changing their own
    preferences. Re-enabling the parent preserves individually disabled bands.
  • Readable paths follow names and configured times. Native switch identities
    remain tied to UUIDs across renames; duplicate names receive distinguishing suffixes.
  • User-context writes require an administrator. Internal HA automation calls
    are supported, and path reads respect the requesting user's entity access.

Example band control:

action: heating_schedule_manager.set_disabled
data:
  path: schedule_manager.schedule1.weekdays.band-on-0700-off-1000.disabled
  disabled: false

The README includes native-switch, discovery, read and write examples, plus
parent-state behaviour, naming rules and solar/unnamed-band conventions.

Included versions

  • Dashboard card: 1.11.0
  • Home Assistant integration: 1.11.0
  • Minimum Home Assistant version: 2026.7.0

Update or install

Download/update Scheduling Manager through HACS, restart Home Assistant, then
refresh your dashboard or reopen the companion app. Existing schedules are retained;
the new Disabled switches are created for your saved schedules and bands.

Without HACS, extract the attached ZIP's custom_components/heating_schedule_manager/
folder into your HA configuration's custom_components/ directory and restart HA.
For an existing installation, keep the integration entry and saved schedules.
The card is bundled and loads automatically.

HACS default-catalogue inclusion remains a separate submission. Until accepted,
use the custom repository instructions or Add to HACS badge in the README.

Verification

All seven CI jobs passed on the release commit:
GitHub Actions results.

  • Nine backend suites across HA 2026.7.0, 2026.8.1, 2026.9.4 and 2026.10.1.
  • Frontend build, 23 unit tests and 72 Chromium browser tests.
  • Ruff, configured formatting, gradual mypy, official hassfest and HACS validation.
  • 12 focused path/control cases and four real HA lifecycle cases cover
    parent inheritance, timers, active starts, persistence failures, identities,
    permissions, filtered reads, deletion, reloads and control-target exclusion.
  • Local combined backend line/branch coverage on HA 2026.8.1: 96.33%.

Write behaviour was tested with mocked devices in isolated HA configurations.
Local deployment checks confirmed startup, preserved saved schedules and matching
native/boolean API states, without toggling production devices. See TEST_RESULTS.md
for test scope and limitations.

Manual-install ZIP SHA256

33b561b3940642cb76eb0c57ab57ccf7f82fbc2c9f0b3aed92f8d59b02c63f82  scheduling-manager-1.11.0.zip

Licensed under GPL-3.0-only; bundled third-party notices are included.