Skip to content

omarshahine/homebridge-valor-fireplace

Repository files navigation

homebridge-valor-fireplace

npm npm

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

HomeKit Screenshot

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

About

Connects real fire with Homebridge.

Resources

License

Stars

0 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors