https://github.com/netr0m/brewsource-rpi
BrewSource, a Raspberry Pi-powered monitor for your fermentation:beers:. Written in :snake:Python and :sailboat:Sails.js
https://github.com/netr0m/brewsource-rpi
beer brewery brewing fermentation opensource python raspberry-pi raspberrypi rpi
Last synced: about 2 months ago
JSON representation
BrewSource, a Raspberry Pi-powered monitor for your fermentation:beers:. Written in :snake:Python and :sailboat:Sails.js
- Host: GitHub
- URL: https://github.com/netr0m/brewsource-rpi
- Owner: netr0m
- License: gpl-3.0
- Created: 2017-05-31T13:27:26.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-06-02T11:42:23.000Z (almost 8 years ago)
- Last Synced: 2025-02-28T11:50:29.597Z (2 months ago)
- Topics: beer, brewery, brewing, fermentation, opensource, python, raspberry-pi, raspberrypi, rpi
- Language: Python
- Homepage: http://brewsource.no/
- Size: 5.89 MB
- Stars: 5
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](http://forthebadge.com) [](http://forthebadge.com)
# [BrewSource | Raspberry Pi Project](http://brewsource.no) - :snake:Python
BrewSource is an open source, Raspberry Pi-powered monitor for your beer fermentation :beers:. Written in :snake:Python and :sailboat:Sails.js. We'd love help of any kind, whether you'd like to contribute by submitting a bug, or have a request for a feature. You can also contribute with development, but please read the guidelines on [Contribution](#contribution) before you begin.
[BrewSource Application Repository](https://github.com/mortea15/BrewSource)
## Table of contents
- [Getting Started](#getting-started)
- [Documentation](#documentation)
- [Features](#features)
- [Bugs and feature requests](#bugs-and-feature-requests)
- [Contribution](#contribution)
- [License](#license)
- [Contributors](#contributors)
## Getting Started
- You will also need [Python 3.x.x](https://www.python.org/downloads/) for the Raspberry Pi in order to get the temperature-monitoring and camera stream going.
- The thermometer script is dependent on a package called _pymongo_
- You'll also need a [DS18B20 Waterproof Digital Temperature Sensor](https://www.adafruit.com/product/381) to read temperatures
- After you've cloned the repository:
- Open a terminal, navigate to your local clone (folder), and type:
```sh
sudo apt-get install python-pip
pip install pymongo
```
- You'll need to create an account, a brewery, and finally a batch which the temperatures belong to
- Copy the ID of the batch you want to monitor, and paste it in the "batchID" variable in the _thermometer.py_ script
- Finally, open the folder _temperature_. Type:
```sh
sudo python thermometer.py
```
**The launcher.sh script is used to run the python script on reboot**
_In order to get this working, you'll need to do the following:_
```sh
sudo crontab -e
@reboot sh /home/pi/brewpi/launcher.sh >/home/pi/logs/cronlog 2>&1
```
## Documentation
https://github.com/mortea15/BrewSource-RPi/wiki
## Features
Coming soon
## Contribution
We would love your help in the development of BrewSource. Please follow our guidelines on [Contribution](#contribution) on how to report bugs and request features you'd like to see, in addition to how you can contribute with development.
By following these guidelines, we make sure that communication is efficient and understandable, which hopefully will help us improve the project.
## Bugs and feature requests
If you want to submit a feature request or bug, please keep this in mind:
- Stay on topic, both regarding the request/bug itself and any discussion around it.
- Please avoid opening issues if it involves lines of code you do not understand.
### Bug reports
Definition of a bug:
A bug is an error, fault or failure in the application which is caused by the sourcecode found in this repository, which results in an incorrect or unexpected result.
We appreciate feedback of any sort, and it helps us in developing a great service. Thank you!
- Please browse the [issue tracker](https://github.com/mortea15/BrewSource-RPi/issues) before you submit a bug or feature, to avoid duplicate entries.
- Before submitting, make sure to pull the latest version to check if the bug is fixed, or feature is implemented.
- Stick to ONE bug per issue.
* Please use the following format when submitting:
**Short description of what happened**
*Description*
**Expected behaviour**
*Description*
**Actual Behaviour**
*Description*
**Steps to reproduce**
*Description*
**Your enviroment**
*Operative System, Python Version, Raspberry Pi version, and any other information of relevance*
### Feature requests
We're open for adding new features, please keep in mind that it should be of relevance to this project.
- Including details when submitting feature requests is essential. It makes it easier for the developers to understand the request.
### Pull requests
- Please include documentation on all code submitted
- If a new feature is implemented, it should be explained with detail in the [Wiki](https://github.com/mortea15/BrewSource-RPi/wiki)
## License
[GPL3.0](https://github.com/mortea15/BrewSource-RPi/blob/master/LICENSE)
## Contributors
**Developed by:**
- [Morten Amundsen.py](https://github.com/mortea15/)
- [Svenn-Roger Sørensen.js](https://github.com/tjodalv2k)