/reef-pi

An opensource reef tank controller based on Raspberry Pi

Primary LanguageJavaScriptOtherNOASSERTION

reef-pi

An open source reef tank controller based on Raspberry Pi

GitHub release Build Status(backend) Build Status(frontend) Build Status(smoke) Build Status(package)

Coverage Status Go Report Card License GoDoc

Introduction

reef-pi is an opensource reef tank controller based on Raspberry Pi. This is the software repository for reef-pi. If you are trying to build a physical controller to automate your reef tank, use reef-pi website. If you are new to reef keeping and want to know about the hobby use one of the online forums such as reef2reef or nano-reef(for smaller reef tanks).

reef-pi is an award winning, modular, do it yourself (DIY) project that aims to provide a hackable, affordable reef tank automation platform using easy to learn electronics. Apart from Raspberry Pi, reef-pi uses a handful of additional electronics boards from adafruit, a open hardware, community-focused electronics company. reef-pi is under active development. Follow reef2reef thread if you want to stay up to date with reef-pi development. Use the build guides on reef-pi website if you just want to build a reef tank controller based on reef-pi. We use slack for developer communication. Click here to join reef-pi slack channel.

Features

  • Web browser based user interface
  • On-demand & timer based control of equipment
  • Sunrise to sunset LED lighting automation
  • Temperature monitoring and control
  • pH monitoring
  • Dosing pump (peristaltic pumps) control
  • Auto Top off
  • Email alerts, charts, and dashboard capabilities. Adafruit.io based telemetry for monitoring.
  • On-demand or automatic tank photo capture with google drive upload using pi camera

Maintainers

Development

To ensure a good development process please follow the Code Of Conduct and the Pull Request Template. To setup your development environment please read this document.

Internationalization

If you want to edit or provide translations to the project, please follow the guide for internationalization.

Currently available languages (but not completed):

  • English
  • French
  • Italian
  • German
  • Hindi
  • Persian
  • Spanish

Acknowledgments

reef-pi would not be possible without these awesome things:

  • Raspberry Pi Foundation
  • Adafruit.com for all peripheral boards, tutorials.
  • go, the programming language that powers reef-pi non-ui parts.
  • react, a javascript framework used by reef-pi user interface.
  • github, the social coding platform that provide reef-pi code, website and release package hosting.
  • embd, go based IoT library used by reef-pi.
  • reef2reef, worlds largets reef tank user forum where reef-pi's original discussion thread is hosted.
  • travis ci for continuous integration service