Software for cheap home automation of your reptile terrarium or any other enclosed environment. With this software you are able to control for example a terrarium so that the temperature and humidity is of a constant value. Controlling the temperature can be done with heat lights, external heating or cooling system. As long as there is one temperature sensor available the software is able to keep a constant temperature.
For humidity control there is support for a spraying system. The sprayer can be configured to spray for an X amount of seconds and there is a minimal period between two spray actions. Use at least one humidity sensors to get a constant humidity value. In order to lower the humidity you can add a dehumidifier.
The software is that flexible that there is no limit in amount of sensors, relay boards or door sensors. The usage can be endless. All power switches have support for timers to trigger based on a time pattern.
Running now stable for more than 10 years!!!
If you are using this software for your animals or plants, please post some pictures
Full documentation can be found at https://theyosh.github.io/TerrariumPI/
Contact https://matrix.to/#/#terrariumpi:theyosh.nl
Think off:
And all this is controlled with a nice web interface with AdminLTE 3 based on Bootstrap 4 made interactive with Svelte 4.
It is currently controling my reptile terrarium since 2014! And my Madagascar Day Gecko is very happy with it!
The software has support for the following languages:
Your language not in the list or not up to date? Create your own language translation
The installation expects a Pi with working network and ssh. It is tested with Raspberry Pi OS Lite Legacy. Desktop images will not work. Installation seems to work, but it will not work stable. So make sure you download the correct image for the Pi. It is possible to use USB or SSD drives to speed things up: https://www.tomshardware.com/how-to/boot-raspberry-pi-4-usb
There is a Docker image which can be used instead of the source code. This should make the installation a bit more easier. More information can be found at: https://theyosh.github.io/TerrariumPI/install/#docker
You can skip the manual installation part.
ssh pi@[raspberry_ip]
sudo apt -y install git
git clone --depth 1 https://github.com/theyosh/TerrariumPI.git
cd TerrariumPI
sudo ./install.sh
sudo reboot
(if done manual)All needed options and modules are setup by the installer script. This means that I2C and 1Wire overlay are enabled by default.
Make sure that your Pi is secured when you put it to the Internet. Would be a shame if TerrariumPI gets next victim 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. When updating between release versions it will take more time due to database updates and cleanups. This can be seen in the log file.
Stop the running container and pull the new image. Then you can start the container again.
ssh pi@[raspberry_ip]
cd TerrariumPI
git pull
sudo ./install.sh
sudo service terrariumpi restart
Now clear your browser cache and reload the web interface. A brand new version should be running.
This software requires a Raspberry Pi and some extra hardware in order to run and work. The bare minimum and tested hardware is
Full list of supported hardware
All hardware that connects to the GPIO pins use Physical GPIO numbering (1 - 40). The software will translate it to BCM if needed for a supported device or sensor. More information about GPIO pin numbering
For the analog devices use numbers of the channel on the analog device which is from 0 to 7 (8 channels). Also the software expect the analog MCP3008 on GPIO ports 19,21,23,24 physical (default). More information about GPIO pin numbering
If there is some other hardware which is not working with TerrariumPI, open an issue on Github and we will try to support it. We can only test it on a Raspberry PI 4.
It is possible to use external sensor data that is available through HTTP(S) in JSON format. This way you can combine multiple Raspberry Pi's with TerrariumPI running to one single system. By using multiple Raspberry PI's you can cover a bigger area. But there are limitations.
Currently it is READONLY. So you can read out remote sensors and switches but you cannot control the remote switches. But this way you can combine the power switches total costs and power usage.
more information is here: Remote data wiki
(made on a very big screen :P )
More screenshots can be found here
Free tested with BrowserStack for open source
A live version is running at: https://terrarium.theyosh.nl/index.html. Go to 'About' menu for more information about used hardware, software and how to setup.