Install Tilt Pi on Raspbian Buster (Compatible with all RPi models, including RPi 4)

Posted by on

"Bleacon", the Bluetooth scanning module used in the original Tilt Pi, no longer appears to install successfully on recent versions of Raspbian. As such, the module has been replaced with a new Python-based equivalent "Aioblescan". These instructions incorporate the new module and were tested on a fresh install of the February 13, 2020 version of Raspbian Buster installed on a Raspberry Pi 0w (this ensures greater compatibility). It has been tested to run successfully on 6 different versions of Raspberry Pi. Feel free to contact us at for feedback or any questions.

Looking for the pre-built disk image? Skip these steps and download our updated SD card image here: or download our HDMI version that will automatically boot into the RPi desktop and launch the Tilt Pi dashboard:

Using SSH from another computer or from the Raspberry Pi terminal, enter the following commands. 

Step 1

Update Raspbian packages and install python install utility, "python3-distutils".

sudo apt-get update --allow-releaseinfo-change

sudo apt-get install python3-distutils

Step 2

Get the “aioblescan” bluetooth scanner module customized with Tilt plugin, unzip downloaded file, go to install folder, and install. Once you complete this step, you can run the command "sudo python3 -u -m aioblescan -T" to verify Tilt scanner is working. Make sure Tilt is nearby and floating if doing the test. Use "ctrl-c" to stop scanning.



cd aioblescan-master/

sudo -H python3 install

Step 3

Install node-red update script for Raspberry Pi using version that works with Google Sheets web apps (this forked install script installs version 0.18.4 which allows following redirects of http POST requests). Answer "yes" to install Raspberry Pi specific nodes.

bash <(curl -sL

Step 4

Install dashboard ui node v2.15.5 globally for node-red and enable auto-start of node-red at boot.

sudo -H npm install node-red-dashboard@2.9.7 -g

Note: For some reason v2.15.5 will not install succesfully unless v2.9.7 is installed first.

sudo -H npm install node-red-dashboard@2.15.5 -g

sudo systemctl enable nodered.service

Step 5

Reboot to start node-red on boot.

sudo reboot

Step 6

Download Tilt Pi “flow” that uses the new Aioblescan module

wget -O /home/pi/flow.json

Step 7

Run downloaded Tilt Pi app/flow in node-red:

curl -X POST http://localhost:1880/flows -H "Content-Type: application/json" -H "Node-RED-Deployment-Type: nodes" --data "@/home/pi/flow.json"

Step 9 (optional)

As an optional step, you can add a WiFi connection manager script that has a robust algorithm to maintain the WiFi connection if the connection is unstable.

curl -L | sudo bash

Step 10

In a web browser visit http://raspberrypi.local:1880/ui or http://localhost:1880/ui (if not using SSH to install). If this doesn't work, you may need to find the IP address of your Raspberry Pi and go to http://X.X.X.X:1880/ui where X.X.X.X is your Raspberry Pi's IP address.

← Older Post Newer Post →