Skip to content

VoidLock/ha-pifire

Repository files navigation

PiFire Home Assistant Integration

hacs_badge GitHub release (latest by date) GitHub license

Home Assistant custom integration for PiFire.
This integration allows you to monitor and control your PiFire-powered pellet grill directly from Home Assistant.

Big shoutout and thanks to @nebhead for making PiFire Possible

📚 Official PiFire documentation is available here:
👉 PiFire Docs


Screenshots

Here’s how the PiFire integration looks in Home Assistant:

PiFire Integration Screenshot


✨ Features

  • ✅ Live grill temperature sensor
  • ✅ Probe 1 & Probe 2 temperature sensors
  • ✅ Pellet level and pellet type sensors
  • ✅ Current grill mode, status, and units
  • ✅ Control grill setpoints & notify temps
  • ✅ One-click buttons for Startup, Shutdown, and Prime
  • ✅ Mode selector (Stop / Smoke / Hold / Monitor, etc.)
  • ✅ [Planned] Auto-discovery via Zeroconf & MQTT

📂 File Structure

The integration lives under:

config/
└── custom_components/
└── pifire/
├── init.py
├── manifest.json
├── const.py
├── config_flow.py
├── sensor.py
├── number.py
├── select.py
├── switch.py
├── button.py
├── diagnostics.py
├── strings.json
└── translations/
└── en.json

Installation

You can install the PiFire integration for Home Assistant either via HACS (recommended) or manually.


Option 1: Install via HACS (Recommended)

  1. Make sure you have HACS installed in your Home Assistant.

  2. In Home Assistant, go to HACS → Integrations.

  3. Open the menu (⋮) in the top right → Custom repositories.

  4. Add this repository URL:https://github.com/VoidLock/ha-pifire Category: Integration

  5. Back in HACS, search for PiFire under Integrations.

  6. Click Download to install it.

  7. Restart Home Assistant.

  8. Go to Settings → Devices & Services → Add Integration.

  9. Search for PiFire, then enter the host or IP of your PiFire controller (e.g. pifire.local or 192.168.x.x).


Option 2: Manual Installation

  1. Download the latest release of this repository as a ZIP file from the Releases page.
  2. Extract the archive.
  3. Copy the folder:custom_components/pifire into your Home Assistant config/custom_components/ directory.
    Your setup should look like:
config/
└── custom_components/
    └── pifire/
    ├── init.py
    ├── manifest.json
    ├── const.py
    ├── config_flow.py
    ├── sensor.py
    ├── number.py
    ├── button.py
    ├── select.py
    ├── pifire_client.py
    ├── strings.json
    └── translations/
        └── en.json
  1. Restart Home Assistant.
  2. Go to Settings → Devices & Services → Add Integration.
  3. Search for PiFire, then enter the host or IP of your PiFire controller.

Updating

  • HACS installs: Update directly through the HACS UI when a new version is released.
  • Manual installs: Replace the pifire folder inside custom_components with the new version from the Releases page, then restart Home Assistant.

Font Attribution

This project’s logo uses the Orbitron font by Matt McInerney, licensed under the SIL Open Font License.

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Home Assistant Integration for PiFire Smoker Controller

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages