homebridge-valor-fireplace

Homebridge plugin for controlling Valor fireplaces with WiFi controllers through Apple HomeKit.

Features

Control your Valor fireplace using Siri and schedule automations with HomeKit scenes. The plugin exposes a Heater accessory with the following features:

| Feature | Description | |---------|-------------| | Lock Controls | Lock access to fireplace controls (turn off is always available for safety) | | Temperature Mode | Set to HEAT in HomeKit for temperature-controlled operation | | Manual Mode | Direct flame control | | Eco Mode | Set to COOL in HomeKit for eco mode | | Auxiliary | Toggle auxiliary features using the Oscillate switch |

Installation

Via Homebridge UI (Recommended)

Search for "valor-fireplace" in the Homebridge UI plugin search and install.

Via Command Line

npm install -g homebridge-valor-fireplace

Configuration

Via Homebridge UI

Configure the plugin through the Homebridge UI settings panel.

Manual Configuration

Add the following to your Homebridge config.json:

{
  "platforms": [
    {
      "platform": "ValorFireplace",
      "fireplaces": [
        {
          "name": "Living Room Fireplace",
          "ip": "192.168.1.100"
        }
      ]
    }
  ]
}

Configuration Options

| Key | Required | Description | |-----|----------|-------------| | platform | Yes | Must be "ValorFireplace" | | debug | No | Enable debug mode to log all status updates (default: false) | | temperatureUnit | No | Temperature unit for logs: "C" for Celsius, "F" for Fahrenheit (default: "C") | | fireplaces | Yes | Array of fireplace configurations | | name | Yes | Display name for the fireplace (also used as serial number) | | ip | Yes | Static IP address of the fireplace WiFi controller |

Requirements

• Tested with: Valor Linear L1 fireplace
• WiFi Hardware: GV60 WiFi Module installed in your fireplace
• Valor10 Remote App: Your fireplace must be compatible with the Valor10 Remote App - see link for list of compatible fireplaces
• Static IP address assigned to the fireplace controller
• Homebridge 1.3.5 or later
• Node.js 14.18.1 or later

Credits

This plugin is based on homebridge-mertik-fireplace by @tritter.

Legal

Valor is a registered trademark of Valor Fireplaces.

This project is not affiliated with, authorized, maintained, sponsored, or endorsed by Valor Fireplaces or any of its affiliates or subsidiaries.

License

MIT