Skip to content

Releases

cmdSwitch3 1.0.0 — first stable release

Choose a tag to compare

@jakemike1 jakemike1 released this 17 Nov 11:18

First stable release

cmdSwitch3 1.0.0 brings local shell and remote SSH switches, momentary actions and dimmable lights to Homebridge 2 on Linux and macOS.

This release promotes the tested beta.6 runtime unchanged. Command execution, switches, dimming, sequential commands, accessory identities, settings assets, configuration rules and dependency versions are identical to beta.6. Changes are limited to version/publishing metadata, documentation and issue-template wording.

  • Install or update through Homebridge UI, searching for homebridge-cmdswitch3, or use npm install -g homebridge-cmdswitch3@latest with your usual Homebridge npm prefix.
  • npm's latest tag selects stable 1.0.0. The beta tag remains on 1.0.0-beta.6; an exact beta.6 install remains available for rollback.
  • Existing cmdSwitch3 users can update normally while retaining configuration, cached accessories and pairing data. Existing cmdSwitch2 users must follow MIGRATION.md; installation does not automatically take over cmdSwitch2 accessories.
  • Requires Homebridge 2 and Node 22, 24 or 26 on Linux or macOS. No runtime npm dependencies or installation hooks.

Validation at release commit 9e453f503ec030a06824848999ec8ee5b12ff959: all nine CI jobs pass across Linux x64, native Linux ARM64 and macOS with Node 22, 24 and 26. Each job runs 78 tests, syntax/shared-validator and formatting checks, plus an offline packed-install/HAP check. Local macOS ARM64 checks also pass. Byte comparisons confirm the runtime, UI and schema match beta.6 and dependency versions are unchanged.

The maintainer has confirmed beta.6 installed and working in everyday Raspberry Pi switch and automation use, including local heating and hot-water command helpers. Physical dimming, multiple-installation sequential use and diverse command scripts still need broader coverage; see TESTING.md.

Homebridge verification request #1287 remains awaiting final review. Stable release status is not Homebridge verification approval. This release does not deploy to or restart the maintainer's Pi.

cmdSwitch3 1.0.0-beta.6 — native settings theme

Choose a tag to compare

@jakemike1 jakemike1 released this 26 Oct 20:53

Native settings theme and platform name

This public beta makes cmdSwitch3's settings feel at home in Homebridge.

  • Uses Homebridge's native dark colours and selected theme accent.
  • Keeps the accessory sidebar darker, while the editor matches the surrounding background. The same layout remains in light mode.
  • Defaults new configurations to cmdSwitch3, so their Homebridge log prefix uses the current plugin name. Existing custom names are preserved.
  • Keeps Advanced preferences → Platform name for optional changes; there is no additional log-label field.
  • Clarifies plugin search: use the full package name homebridge-cmdswitch3 if a broad search does not list it.

Command execution, SSH support, switches, dimming, sequencing, accessory identities and dependency versions are unchanged from beta.5. Existing cmdSwitch2 installations still need to follow MIGRATION.md.

Install with npm install -g homebridge-cmdswitch3@beta using your usual Homebridge npm prefix, or search the full package name in Homebridge UI. npm's latest and beta tags both select this prerelease; no stable 1.0.0 has been released.

All nine CI jobs pass at release commit 6a2e6740d15a2bc2cde710dcf99616d62c5e70eb: Linux x64, native Linux ARM64 and macOS with Node 22, 24 and 26. Each job passes all 78 tests, syntax/shared-validator and formatting checks, and an offline packed-install/HAP smoke check. The updated theme was also checked locally in light, dark and narrow layouts.

See TESTING.md for community testing instructions and remaining hardware coverage gaps. Homebridge verification request #1287 remains under review. The maintainer's Pi was left unchanged on beta.5; beta.6 has not been deployed there.

cmdSwitch3 1.0.0-beta.5 — SSH examples and settings help

Choose a tag to compare

@jakemike1 jakemike1 released this 22 Oct 21:15

SSH examples and settings help

cmdSwitch3 runs local shell commands or remote commands over SSH from Homebridge 2 switches and dimmers. This public beta makes its existing SSH support easier to discover and configure.

  • Adds service-account SSH setup, remote switch and momentary-action examples, and dimming with HB_BRIGHTNESS to the README.
  • Explains reliable status handling: exit 0 is ON, exit 1 is OFF, and opt-in strict state checks preserve the last confirmed state on other failures. Includes a helper that separates OFF from SSH or remote-command errors.
  • Adds a collapsible SSH examples & status section to Settings, with switch/dimmer examples and clearer strict-state guidance.
  • Adds ssh, openssh, ssh-switch, ssh-commands, remote-control and shell-command search keywords. npm controls indexing and ranking, so broad searches may take time to reflect the metadata. Full-name homebridge-cmdswitch3 lookup remains available.

Runtime behaviour, configuration defaults, accessory identities and dependencies are unchanged from beta.4. SSH uses the host's existing client and credentials; there are no new credential fields or connection manager, and strict state checks remain opt-in. Existing cmdSwitch2 users still need to follow MIGRATION.md.

Install with npm install -g homebridge-cmdswitch3@beta using your usual Homebridge npm prefix, or search the full package name in Homebridge UI. npm's latest and beta tags both select this prerelease; no stable 1.0.0 has been released.

All nine CI jobs pass at release commit e938f5bbd4d7e3e4a2c854f5dc26efd96522f1b7: Linux x64, native Linux ARM64 and macOS on Node 22, 24 and 26. Each job runs the 77-test suite, syntax/shared-validator and formatting checks, and an offline packed-install/HAP smoke check. Local Node 26/macOS ARM64 checks also pass.

Three README JSON examples validate, four shell examples parse, and eight mocked status-helper cases cover ON/OFF and failures. Expanded settings help was checked in desktop light, narrow light and narrow dark layouts. Remote SSH commands and physical device actions were not executed. See TESTING.md for community testing instructions and remaining hardware coverage gaps.

Homebridge verification request #1287 is still under review; this release is not verification approval. The maintainer's Pi remains unchanged.

cmdSwitch3 1.0.0-beta.4 — search discovery improvements

Choose a tag to compare

@jakemike1 jakemike1 released this 22 Oct 20:35

Search discovery improvements

This public beta makes cmdSwitch3 easier to identify as a maintained cmdSwitch2 successor for Homebridge 2.

  • Adds cmdswitch, cmdswitch2, cmdswitch3, command-switch and shell to the npm keywords, retaining Homebridge's required discovery and HAP keywords.
  • Clarifies the package description: command switches, dimmers, sequential commands and optional quiet logging.
  • Includes the approved icon in the README and documents the full-name homebridge-cmdswitch3 search in Homebridge UI. npm controls search indexing and ranking; results may take time to update.
  • Documents the aligned latest and beta tags. Both select a prerelease; no stable 1.0.0 has been released.

Runtime, settings UI, configuration schema and dependencies are unchanged from beta.3. No accessory names, identities or configuration behavior change in this release. Existing cmdSwitch2 users still need to follow MIGRATION.md; this is not an automatic takeover of existing accessories.

Install with npm install -g homebridge-cmdswitch3@beta using your usual Homebridge npm prefix, or search the full package name in Homebridge UI. See TESTING.md for test instructions and remaining hardware/community testing gaps.

All nine CI jobs pass at release commit 6a59fd21b4f6d0206d01439587b5c3c500bb9b92: Linux x64, Linux ARM64 and macOS on Node 22, 24 and 26. Each job passes 77 tests, syntax/shared-validator and formatting checks, and an offline packed-install/HAP smoke check. The local Node 26/macOS checks also pass.

Homebridge verification request #1287 is awaiting final review; this is not verification approval. The maintainer's Pi remains unchanged.

cmdSwitch3 1.0.0-beta.3 — startup and cleanup hardening

Choose a tag to compare

@jakemike1 jakemike1 released this 22 Oct 18:38

Public beta for Homebridge 2 on Linux and macOS. This update hardens startup and command cleanup while retaining switch/dimmer identities and existing command semantics.

  • Invalid settings, malformed cached accessories and unexpected startup/state-update failures stop the affected platform with a sanitized diagnostic. Cached accessories are retained; errors remain visible with No logs enabled.
  • A missing switch list stays inactive. An explicit empty list still intentionally removes that platform's cached accessories when applied.
  • stdout/stderr stream errors stop the command safely. Shutdown closes the scheduler before releasing queued work.
  • Adds lifecycle/stream regression tests and offline packed-install checks. Documents error recovery, the custom editor's first-platform limitation and portable test examples.

Validation covers 77 tests, syntax/shared-validator checks, formatting and a real packed-install/HAP smoke on Linux and macOS with Node 22, 24 and 26. See the release-commit CI results for commit 90d4a6900f92ebc59b1631b6b7e8fce4cf1cd0b0.

Install using your Homebridge plugin npm environment:

npm install -g homebridge-cmdswitch3@beta

For an exact version, use homebridge-cmdswitch3@1.0.0-beta.3. Read TESTING.md and MIGRATION.md. Installing this package does not automatically migrate cmdSwitch2 accessories. Existing installations change only when their owner updates them; the maintainer's Pi remains unchanged.

This is beta software and is not Homebridge-verified. Physical dimming, controller-side automations and prolonged operation still need broader testing. No runtime npm dependencies. Apache-2.0; original attribution and licence retained.

cmdSwitch3 1.0.0-beta.2 — first public beta

Choose a tag to compare

@jakemike1 jakemike1 released this 21 Oct 19:33

First public beta of cmdSwitch3 for Homebridge 2.

Includes command switches, dimmers, momentary actions, sequential execution, a responsive settings page and opt-in quiet logging. Runtime fixes cover execution deadlines, bounded queues, command errors, state races and cleanup. There are no runtime npm dependencies.

Install in your Homebridge environment with npm install -g homebridge-cmdswitch3@beta. This is a testing release, not stable 1.0.

Start with a fresh or isolated setup. Read TESTING.md and report results through Issues. Existing cmdSwitch2 users must read MIGRATION.md; installing this package does not automatically transfer existing accessories.

All 68 tests pass on Node 22.23.3, 24.19.0 and 26.0.0 with Homebridge 2.4.0. Runtime and packaged settings assets match the private beta.1 already running on one Pi, whose six switch identities and pairing data were preserved. Physical dimming and controller-side automation execution still need broader testing. Beta.2 adds public release metadata, documentation, testing instructions and CI.

Apache-2.0; original cmdSwitch2 attribution and licence retained.