Skip to content

A reverse engineered server for the proprietary PicoBrew protocol

License

Notifications You must be signed in to change notification settings

brianacraig/picobrew-server

 
 

Repository files navigation

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

About

A reverse engineered server for the proprietary PicoBrew protocol

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 47.2%
  • HTML 43.8%
  • CSS 9.0%