A command-line tool to control your Valor Fireplace (powered by Mertik) directly from your terminal.

• ✅ Fahrenheit or Celsius - Choose your preferred temperature unit
• ✅ Easy commands (on, off, status, temp, mode)
• ✅ Direct fireplace control via TCP/IP
• ✅ No dependencies on Homebridge
• ✅ Standalone binary

To use this CLI tool (or the official Valor mobile app), your Valor Fireplace must have the Valor WiFi Upgrade Kit installed:

• Required Hardware: Valor WiFi Upgrade for V-module Kit - GV60WiFi
• Compatible Models: Valor L1, L1 See Thru, L2, L3, LT1, LT2, LX1, LX2, H5, H6, and P2 Heaters
• Official Mobile App: Valor 1.0 Remote App
• Installation Guide: GV60WIFI Upgrade Instructions (PDF)

This WiFi module enables TCP/IP control over your local network, which is what this CLI tool uses to communicate with your fireplace. Once the GV60WiFi module is installed and connected to your network, you can use either the official Valor mobile app or this command-line tool.

git clone https://github.com/omarshahine/valor-valor-cli.git
cd valor-valor-cli
npm install

# Copy the example configuration
cp .fireplace-config.example .fireplace-config

# Edit with your fireplace's IP address
nano .fireplace-config

Set your fireplace's IP address in .fireplace-config:

FIREPLACE_IP=192.168.1.XXX  # Replace with your fireplace's IP
TEMPERATURE_UNIT=F          # F for Fahrenheit, C for Celsius

npm run build

# Using the wrapper script (easiest)
./fp status
./fp temp 72
./fp on
./fp off

# Or use the CLI directly
valor-cli status
valor-cli temp 72

npm link
valor-cli status  # Use from anywhere

• temperature - Temperature control mode
• manual - Manual flame height control
• eco - Energy saving mode
• off - Turn off

Create or edit .fireplace-config:

# Fireplace IP address
FIREPLACE_IP=192.168.1.141

# Temperature Unit: F (Fahrenheit) or C (Celsius)
# Default: F
TEMPERATURE_UNIT=F

Temperature Unit Options:

• TEMPERATURE_UNIT=F - Display and input temperatures in Fahrenheit (41-97°F)
• TEMPERATURE_UNIT=C - Display and input temperatures in Celsius (5-36°C)

export FIREPLACE_IP=192.168.1.141

Add to your ~/.zshrc for persistence:

echo 'export FIREPLACE_IP=192.168.1.141' >> ~/.zshrc
source ~/.zshrc

valor-cli status 192.168.1.141

Comfortable Settings:

• 68°F - Cool comfort
• 72°F - Standard warmth
• 75°F - Warm
• 77°F - Extra warm

Valid Range: 41°F to 97°F

Comfortable Settings:

• 20°C - Cool comfort
• 22°C - Standard warmth
• 24°C - Warm
• 25°C - Extra warm

Valid Range: 5°C to 36°C

Note: The fireplace uses Celsius internally. When using Fahrenheit, temperatures are automatically converted. All calculations remain accurate regardless of your display preference.

📖 For more details about temperature units, see TEMPERATURE_UNITS.md

# Check status
valor-cli status

# Turn on and set temperature
valor-cli on
valor-cli temp 72

# Change mode
valor-cli mode eco

# Turn off
valor-cli off

./fp status
./fp temp 72
./fp mode temperature

Fireplace Status:
──────────────────────────────────────
Mode:               Temperature
Current Temp:       68°F
Target Temp:        72°F
Guard Flame:        On
Igniting:           No
Shutting Down:      No
Aux On:             No
Reachable:          Yes
──────────────────────────────────────

valor-valor-cli/
├── src/                    # TypeScript source code
│   ├── cli.ts             # Main CLI interface
│   ├── controllers/       # Fireplace control logic
│   ├── models/            # Data models and status parsing
│   └── utils/             # Temperature conversion, config reader
├── dist/                  # Compiled JavaScript
├── fp                     # Quick wrapper script ⭐
├── .fireplace-config      # Configuration file
├── package.json           # NPM configuration
├── tsconfig.json          # TypeScript config
├── README.md              # Documentation
└── LICENSE                # Apache 2.0

npm run build

npm run clean && npm run build

npm link
valor-cli status

This project is standalone and can be:

1. Cloned and used locally:

   git clone https://github.com/yourusername/valor-valor-cli.git
   cd valor-valor-cli
   npm install
   npm run build
   ./fp status

2. Installed globally:

   npm install -g valor-valor-cli
   valor-cli status

3. Shared as source:

   • Zip the folder
   • Recipients need Node.js >= 14.18.1
   • Run npm install && npm run build

• Protocol: TCP socket connection on port 2000
• Hardware: Valor WiFi Module (GV60WiFi) using Mertik protocol
• Temperature Range: 41-97°F (5-36°C internally)
• Connection Timeout: 5 minutes
• Status Refresh: 15 seconds
• Ignition Time: 30-40 seconds
• Shutdown Time: 30 seconds

See TEMPERATURE_UNITS.md for detailed information about using Celsius or Fahrenheit.

• Modify source code in src/ directory
• Rebuild with npm run build
• Temperature ranges can be adjusted in src/utils/temperatureConverter.ts

• Check fireplace is powered on
• Verify IP address is correct
• Ensure on same network
• Try: ping 192.168.1.141

npm run build
npm link

• Fahrenheit: Valid range is 41-97°F
• Celsius: Valid range is 5-36°C
• Check your TEMPERATURE_UNIT setting in .fireplace-config

npm run clean
npm install
npm run build

• Node.js >= 14.18.1
• TypeScript >= 4.4.4
• macOS, Linux, or Windows with WSL

This project is built upon the excellent work from:

• homebridge-mertik-fireplace by tritter

Apache-2.0

Omar Shahine

Your fireplace, your command line. 🔥