homebridge-bestway

A Homebridge plugin for controlling Bestway and Lay-Z-Spa Wi-Fi enabled hot tubs.

This plugin allows you to expose your spa to Apple HomeKit, giving you control over the heater, filter, and massage bubbles.

Features

• Thermostat Control: Set target temperature and toggle heating.
• Filter Control: Turn the water filter pump on or off (exposed as a Switch).
• Bubbles Control: Control the massage system (exposed as a Fan/Speed Control for spas that support variable speeds, or a simple Switch for others).
• Temperature Units: Supports both Celsius and Fahrenheit (based on your region settings).

Installation

Graphical Install (Recommended)

1. Open the Homebridge UI.
2. Navigate to the Plugins tab.
3. Search for Bestway or homebridge-bestway.
4. Click Install.

Manual Install

If you prefer the command line:

npm install -g homebridge-bestway

Configuration

This plugin comes with a schema definition for the Homebridge UI.

1. In the Homebridge UI, go to the Plugins tab.
2. Find homebridge-bestway.
3. Click Settings.
4. Enter your Bestway account email and password.
5. Select your Region (EU or US).
6. Save and restart Homebridge.

Configuration Fields (Manual)

If you are editing config.json manually, here are the available fields:

• email (Required): Your Bestway account email address.
• password (Required): Your Bestway account password.
• region (Optional): The region for your account (EU or US). Defaults to EU.
• minTempC / maxTempC (Optional): Override the logic minimum/maximum temperature in Celsius (for EU users).
• minTempF / maxTempF (Optional): Override the logic minimum/maximum temperature in Fahrenheit (for US users).

Example config.json

{
  "platforms": [
    {
      "platform": "Bestway",
      "email": "[email protected]",
      "password": "your-password",
      "region": "EU"
    }
  ]
}

Temperature Units & Region

The plugin attempts to handle temperature conversions automatically:

• EU Region: Input and output generally expected in Celsius.
• US Region: Input and output generally expected in Fahrenheit.

HomeKit natively uses Celsius, so the plugin performs necessary conversions behind the scenes if you are in a US region using Fahrenheit.

Disclaimer

This plugin is a volunteer effort and is not officially affiliated with, endorsed by, or supported by Bestway or Lay-Z-Spa.