# CraftBeerPi

[CraftBeerPi](https://craftbeerpi.gitbook.io/) is an open-source brewing controller software that runs on a Raspberry Pi, providing automated control of mashing, boiling, and fermentation processes.

The plugins listed below are **community-maintained** and are not official Brewfather integrations. They were created by Brewfather users to bridge CraftBeerPi with Brewfather's logging capabilities.

{% hint style="info" %}
These plugins were built for **CraftBeerPi v3**. If you are using CraftBeerPi v4, check the respective GitHub repositories for compatibility notes or look for updated forks.
{% endhint %}

### Available Plugins

Logging to **Custom Stream**: <https://github.com/jnosek/cbpi_Brewfather/>\
Posts fermentation data from CraftBeerPi to Brewfather's [Custom Stream](https://docs.brewfather.app/integrations/custom-stream) endpoint.

For **Tilt Hydrometer** find it here: <https://github.com/mowbraym/brewfather>\
Forwards Tilt Hydrometer readings collected by CraftBeerPi directly to Brewfather.

For **iSpindel** go here: <https://github.com/ZeSlammy/Brewfather_iSpindel> or <https://github.com/netanelbe/Brewfather_iSpindel> or <https://github.com/mowbraym/Brewfather_iSpindel>\
Sends iSpindel data collected by CraftBeerPi to Brewfather. Multiple forks are available with varying feature sets.

## How the Integration Works

CraftBeerPi collects sensor data (temperatures, gravity readings from connected hydrometers, etc.) and these community plugins forward that data to Brewfather. The two main approaches are:

* **Custom Stream** -- The plugin posts fermentation data to Brewfather's [Custom Stream](https://docs.brewfather.app/integrations/custom-stream) endpoint. You enable Custom Stream in **Settings > Power-ups** and use the generated URL in the CraftBeerPi plugin configuration.
* **Device-specific forwarding** -- For Tilt or iSpindel data collected by CraftBeerPi, the plugins forward the readings to the corresponding Brewfather device endpoint. Enable the relevant device integration (Tilt or iSpindel) in **Settings > Power-ups** and use the generated URL or ID.

In all cases, data should not be logged more than once every 15 minutes per device name.

## Related docs

* [Custom Stream](https://docs.brewfather.app/integrations/custom-stream)
* [Devices](https://docs.brewfather.app/devices)