Software for cheap home automation of your reptile terrarium or any other enclosed environment. With this software you are able to control an enclosed environment so that the temperature and humidity is of a constant value. This is done by using temperature and humidity sensors and realy switches to activate external devices.
It has support for lights, sprayer, heater and cooler equipment. The amount of devices that can be controlled depends on the used relay boards.
Think off:
- Terrarium
- Aquarium
- Growhouse
And all this is controlled with a nice webinterface based on Gentelella a Bootstrap 3 template.
- Controlling electronic devices like lights, sprayers, heating and cooling equipment
- Reading out temperature and humidity sensors
- Open door detection (sprayer will not spray when a door is open)
- Support for native Raspberry Pi cam out of the box
- Support for USB and remote webcams
- Total power and water usage for costs calculation
- Lights control based on sun rise and sun set or timers
- Rain control based on measured humidity
- Heater control based on temperature sensors or timers
- Cooling control based on temperature sensors or timers
- Weather forecast from external source
- Temperatures in Celsius or Fahrenheit
- Alarm detections
It is currently controling my reptile terrarium for more then three years! And my Madagascar Day Gecko is very happy with it!
The software has support for the following languages:
- English
- Dutch
- German
- Italian
Your language not in the list? Create your own language translation
- Get a working Raspberry Pi and login as user 'pi'
- Clone this repository and submodules!:
git clone --recursive https://github.com/theyosh/TerrariumPI.git
- Run
./install.sh
in the cloned folder - Reboot Raspberry PI to get all the needed modules loaded
- Go to the webinterface at http://[raspberry_ip]:8090
If you want to use the Raspberry PI 1 wire interface, you have to manually enable it through the raspi-config and reboot once more.
Make sure that your Pi is secured when you put it to the Internet. Would be a shame if TerrariumPI gets next fictum of 'A smart fish tank left a casino vulnerable to hackers' :P
This updating is based on that the software is installed with the steps in the Installation above.
- Login with user 'pi' in Raspberry Pi
- Enter the TerrariumPI directory:
cd TerrariumPI
- Run
git pull
to get the latest version - Restart TerrariumPI according to: https://github.com/theyosh/TerrariumPI/wiki/FAQ#how-to-restart-terrariumpi
Now clear your browser cache and reload the webinterface. A brand new version should be running.
This software requires some extra hardware in order to run and work. The bare minimun is
- Power relay board
- USB versions (Serial and Bitbang)
- GPIO versions
- Temperature/humdity sensors DHT11, DHT22, AM2303, DS1820, HIH4000, etc through
- OWFS
- GPIO
- 1 Wire interface
If there is some other hardware which is not working with TerrariumPI, open an issue on Github and we will try to support it.
(made on a very big screen :P )
More screenshots can be found here
A live version is running at: https://terrarium.theyosh.nl/index.html. Go to 'Help' menu for more information about used hardware, software and how to setup.