Skip to content
If you can save a number in a file, you can display it in the SUPLA.
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
img Add forecast.png Feb 3, 2020
var Sample config and var directory Jan 31, 2020
.gitignore New script that builds filesensors from sources Feb 2, 2020 Link to supla-virtual-device Feb 29, 2020


SUPLA Filesensors

This project has been completely replaced by the supla-virtual-device. Go there for installation and running instructions.

This readme still serves as a source of ideas of what you can save to a file and display in SUPLA.

What can I do?

You need to find a way of putting meaningful numbers into the files mentioned in the channels configuration. Thay can come from anywhere and mean anything. It's totally up to you.

I will post some examples here just to make you aware of what and how can be accomplished. But the main idea often boils down to one of these patterns:

  • get the value periodically at specific intervals; this involves executing your command that puts new values in monitored values with cron
  • get the value continously with a process that is constantly run; such process should be configured similarily to the supla-dev or supla-filesensors with init.d or supervisor; I will post supervisor configuration examples below

So let's proceed with the examples!

Read some interesting APIs out there

There are plenty of public APIs that offer some interesing data you might want to display and use in SUPLA. They are often available in JSON format so you will need a jq tool to read them. Go ahead and install it.

sudo apt-get install jq

And explore!


AIRLY image

Airly publishes air quality and some weather conditions as a public API. You need to generate an API key and know the coordinations of where you live and you can fetch the data it publishes, save it in a file... And display in SUPLA :-)

See an example URL (it will not work because of invalid API Key):

Change the coordinates and API Key to your data and see the output. You can easily consume it and save the PM10 and PM2.5 values in a file with the following crontab:

*/10 * * * * (AIRLY_DATA=$(curl -s '') && echo $AIRLY_DATA | jq '.current.values[] | select(.name=="PM10") | .value' && echo $AIRLY_DATA | jq '.current.values[] | select(.name=="PM25") | .value') > /home/pi/airly.txt


Syngeos like Airly, publish data on air quality, pressure etc. There is no need to generate an API key here. All you have to do is go to the page Syngeos Map and select the sensor you are interested in. An example for Wojkowice:

Add the crontab below and change the final digit of the address (187) to the sensor of your choice

*/10 * * * * (SYNGEOS_DATA=$(curl -s '') && echo $SYNGEOS_DATA | jq '.sensors[4] | select(.name=="pm10") | .data[0].value' && echo $SYNGEOS_DATA | jq '.sensors[3] | select(.name=="pm2_5") | .data[0].value') > /home/pi/syngeos-air.txt

For atmospheric pressure:

*/10 * * * * (SYNGEOS_DATA=$(curl -s '') && echo $SYNGEOS_DATA | jq '.sensors[2] | select(.name=="air_pressure") | .data[0].value') > /home/pi/syngeos-pressure.txt


Forecast image


It's quite easy to get forecast info with OpenWeatherMap API. You need to sign in and get your APP ID, but then you are good to go and consume the API. For example, you can display the anticipated temperature that will be at your location in e.g. 6 hours with the 5 days forecast endpoint.

0 0 * * * curl -s 'ów,pl&units=metric&appid=YOUR_API_KEY' | jq '.list[1].main.temp'


How many commits SUPLA developers made in the last week? Are they working at all?

0 0 * * * curl -s '' | jq '.[0].total' > /home/pi/supla-progress.txt

Github image

Get measurements from HTML / XML pages

In order to consume HTML/XML output nicely, it's good idea to use CSS selectors. Luckily, there is a pup tool that offers CSS selectors in command line. Go to the pup releases and download a binary suitable for your machine. It is also a good idea to move it to /usr/bin so it is globally available as pup command. For example, for Raspberry, it would be:

sudo apt-get install unzip
wget -O
sudo mv pup /usr/bin

Display PLN-EUR exchange rate

The exchange rate is for example available on

Looking at the HTML, the interesting part is:

<span class="kurs kurs_sprzedazy">4,2828</span>

So we can get this with pup and save it in a file for supla-filesensors every hour:

0 0 * * * curl -s '' | pup '.kurs_sprzedazy text{}' | sed 's/,/./' > /home/pi/exchange_rate.txt

Also notice how the sed is used to replace comma , to dot . so the SUPLA is not confused with the number format.

Read measurements from Bluetooth devices

For this you need to have a Bluetooth module on the device you run this program (seems obvious right?). Raspberry Pi Zero W is considered to have very decent Bluetooth range.

In order to get measurements from any Bluetooth sensor you need to find out it's MAC address. Therefore, it might be a good idea to start with finding it:

sudo hcitool lescan



Download script from and install all of its prerequisites. Then use it to save the readings to a file. Use this file to send values to the SUPLA pretending it is a DHT-22 sensor.

Example installation:

mkdir mi-temp
cd mi-temp
echo '#!/bin/bash' >
echo 'echo $3 > sensor_$2.txt' >>
echo 'echo $4 >> sensor_$2.txt' >>
chmod +x

And then read its measurements:

./ --device A4:C1:38:2B:99:64 --round --debounce --name mysensor --callback

The terminal should show you the measurements repeatedly. Stop it with Ctrl+C. Take a look at the sensor_mysensor.txt file. It should contain measurements last seen by the script in two lines.

Add a TEMPERATURE_AND_HUMIDITY channel in supla-filesensors.cfg pointing at the resulting file.

Last but not least, add the following configuration to the supervisor that will take care about running the reading script for you.

command=python3 ./ --device A4:C1:38:2B:99:64 --round --debounce --name mysensor --callback

If you have more than one sensor

  1. Duplicate the supervisor config for reading script with different name (e.g. [program:mi-temp-2])
  2. Change the --name mysensor to something different (e.g. --name livingroom)
  3. Add new channel in the supla.cfg pointing at the file with the measurement name (e.g. /home/pi/mi-temp/sensor_livingroom.txt)
  4. Restart supervisor.

Get anything you can measure

Show how many storage is left on hard drive

Pi image

*/30 * * * * df -h --total / | awk '{print $5}' | tail -n 1 > /home/pi/storage.txt

More ideas?

I will be more than happy to accept pull requests with your ideas of what measurements we can integrate with SUPLA by using this simple tool.

You can’t perform that action at this time.