Skip to content
A reverse engineered server for the proprietary PicoBrew protocol
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
beerxml
blueprints
docs @ b9c4d94
recipes
static
templates
.gitignore
.gitmodules
LICENSE
Procfile
README.md
requirements.txt
server.py

README.md

picobrew-server

This is a reverse engineered server for the proprietary PicoBrew protocol. The PicoBrew Zymatic is a machine to homebrew beer. Since their Firmware is not yet open sourced (they intend to release it at some point) it is missing an offline mode this server can be used as an alternative.

HTTP API

The PicoBrew's built-in Ardunio uses an unencrypted HTTP communication protocol. All request are GET requests and are not authenticated. The following documentation is based on Firmware 1.18.

Complete API Docs

Installation

  • Install Python 2.7 and its requirements
// Install Python requirements
pip install -r requirements.txt

// Start the server
sudo python server.py
  • Connect the PicoBrew machine to your computer and enable DNS spoofing. Re-route www.picobrew.com to your computer. More Details

Demo

You can try out the admin UI for uploading your XML files in this online demo. Please note, this website is for showcasing only and you should deploy your own version.

Features

  • Import BeerXML files
  • Send all your recipes to the PicoBrew
  • Send cleaning recipes to the PicoBrew
  • Session Logging
  • Session Recovery
  • Admin Web UI

ToDo

  • Session Charts

Disclaimer

This software is provided "as is" and any expressed or implied warranties are disclaimed. This software submits recipes with temperature targets to your PicoBrew machine and will cause it to heat water. Any damage to your PicoBrew machine is at your own risk.

License

MIT @ Tom Herold

You can’t perform that action at this time.