A replacement web interface for BrewPi
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Tilt Monitor Refactoring (#314) Oct 19, 2018
brewpi-script Minor Bugfixes (#331) Feb 10, 2019
collected_static Add Git & Circus Integration Feb 5, 2017
data
docs
docs_mkdocs Background Firmware Flashing (#251) Mar 25, 2018
fermentrack_django
firmware_flash Bugfixes & Sentry Opt-out Apr 14, 2018
gravity Misc Bugfixes Oct 24, 2018
lib Minor Bugfixes (#331) Feb 10, 2019
log Circus changes Feb 13, 2017
utils Misc Bugfixes Oct 24, 2018
.gitignore
LICENSE Update documentation Mar 1, 2017
README.md Gravity Refactor and Other Fixes Jul 18, 2018
circus.ini Fix Constance & BrewPi-Script Bugs Mar 20, 2018
manage.py Rename of brewpi_django -> fermentrack_django Feb 15, 2017
requirements.txt Misc Bugfixes Oct 24, 2018

README.md

Fermentrack

Fermentrack Logo

Documentation Status

A replacement web interface for BrewPi

Fermentrack is an application designed to manage and log fermentation temperatures and specific gravity. It acts as a complete replacement for the web interface used by BrewPi written in Python using the Django web framework. It also can track Tilt Hydrometers and iSpindel specific gravity sensors - both alongside BrewPi controllers as well as by themselves.

Fermentrack is Python-based, does not require PHP5, and works with Raspbian Stretch or later including on Raspberry Pi 3 B+. Fermentrack is intended to be installed on a fresh installation of Raspbian and will conflict with brewpi-www if installed on the same device.

Want to see it in action? See videos of key Fermentrack features on YouTube!

Included with Fermentrack

  • Fermentrack - Django-based fermentation tracking and control interface. Replaces brewpi-www. Licensed under MIT license.
  • brewpi-script - Installed alongside Fermentrack to control BrewPi controllers. Licensed under GPL v3.
  • nginx - A reverse proxy/webserver. Licensed under 2-Clause BSD-like license.
  • circusd - A python-based process manager. Licensed under the Apache license, v2.0.
  • chaussette - A wsgi server. Licensed under the Apache license, v2.0.

New Features

One of the key reasons to write Fermentrack was to incorporate features that are missing in the official BrewPi web interface. The following are just some of the features that have been added:

  • Native multi-chamber support
  • Cleaner, more intuitive controller setup
  • Integrated support for ESP8266-based controllers
  • Official support for "legacy" controllers
  • Native support (including mDNS autodetection) for WiFi controllers
  • Integrated specific gravity sensor support, including for Tilt Hydrometers and iSpindel devices

A full table of controllers/expected hardware availability is available https://fermentrack.readthedocs.io/.

Installation & Documentation

Full documentation for Fermentrack (including complete installation instructions) is available at https://docs.fermentrack.com/.

Quick Installation Instructions

  1. Set up your Raspberry Pi (Install Raspbian, enable SSH)
  2. Log into your Raspberry Pi via the terminal or SSH and run curl -L install.fermentrack.com | sudo bash
  3. Wait for the installation to complete (can take ~45 mins) and log into Fermentrack

Requirements

  • Raspberry Pi Zero, 2 B, or 3 /w Internet Connection
  • Fresh Raspbian install (Stretch or later preferred, Jessie supported)
  • 1GB of free space available

PLEASE NOTE - Fermentrack is currently intended to be installed on a fresh installation of Raspbian. It is not intended to be installed alongside brewpi-www and will conflict with the apache server brewpi-www installs.