Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Software I use on the PiFan

Do you want to display Fahrenheit instead of Celsius? Please checkout the fahrenheit branch (on Pi up to Pi3B)

Please also checkout the Pi hardware compatibility list below


Be advised: For this guide, the files will be checked out into
/home/pi/pifan. If you choose to checkout to another location, please adjust the paths in the installation commands and the scripts accordingly.

Install the software, setup the configuration and reboot

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install nginx-light supervisor git build-essential python-dev python-pip
service nginx stop
service supervisor stop
git clone /home/pi/pifan
mkdir -p /home/pi/.config/autostart/
cp /home/pi/pifan/config/AutoChromium.desktop /home/pi/.config/autostart/AutoChromium.desktop
chmod +x /home/pi/pifan/hub-ctrl
sudo pip install -r /home/pi/pifan/config/requirements.txt
git clone /tmp/dht
cd /tmp/dht
sudo python install
sudo rm /etc/nginx/sites-enabled/default
sudo cp /home/pi/pifan/config/nginx-sites-enabled-default /etc/nginx/sites-enabled/default
sudo cp /home/pi/pifan/config/supervisor-falcontrol.conf /etc/supervisor/conf.d/falcontrol.conf
sudo cp /home/pi/pifan/config/supervisor-usb_switch.conf /etc/supervisor/conf.d/usb_switch.conf
sudo cp /home/pi/pifan/config/supervisor-tempreader.conf /etc/supervisor/conf.d/tempreader.conf
sudo reboot

After the reboot, Chromium should start and it should present you with the touchinterface If you don't want to reboot and start Chromium yourself, you should run service supervisor start; service nginx start

Optionally, remove stuff that you do not need

sudo apt-get remove cups-bsd cups-client cups-common scratch greenfoot bluej sense-emu-tools sense-hat claws-mail libreoffice-base
sudo apt-get remove --purge libreoffice*


Raspberry Pi

Offcourse you need a Raspberry Pi. There are multiple Pi models, not every Pi would work.

Thanks to @koenvervloesem from the MagPi NL I can provide you this overview:

Model Suitable for PiFan Comment
Pi Zero and Pi Zero W No These models don't have a USB hub
Pi 1 Model B No The USB ports for this model are not controllable
Pi 1 Model B+ Pi 2 Pi 3B Yes These all work without modifications
Pi 3B+ Yes Since 2018-10-22 it works on the master branch

Temperature Sensor

For the temperature readings I chose the DHT22 from Adafruit. This sensor is pretty accurate. You can also choose to use the DHT11, it's a little bit cheaper but less accurate. I have bought the one already attached to a chip.

Touch screen and acrylic case

The touch screen that has been used for this project is a 3,5" capacative touch display. It comes with a cool acrylic case. This case also takes care of supporting the display. You can find them on eBay. At the time of writing, you could buy this one

Btw: Please let me know when the link is dead.


Here's the scheme of the wiring. The display is just for illustration purposes to see which pins are allocated by the action touchscreen. Use the image to hook up the DHT22 temprature sensor. Wiring of the PiFan



Software I use on the PiFan








No releases published


No packages published