https://github.com/ynodd/simple-terminal-based-airing-app

App that compares inside and outside values and shows whether airing is needed, based on humidity and temperature
https://github.com/ynodd/simple-terminal-based-airing-app

absolute-humidity absolute-luftfeuchte airing humidity-monitoring lueft-app lueften luftfeuchtigkeit temperature-monitoring terminal-based ventilation

Last synced: 8 months ago
JSON representation

App that compares inside and outside values and shows whether airing is needed, based on humidity and temperature

• Host: GitHub
• URL: https://github.com/ynodd/simple-terminal-based-airing-app
• Owner: YNodd
• License: mit
• Created: 2025-02-05T14:22:09.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-03T11:46:20.000Z (over 1 year ago)
• Last Synced: 2025-10-09T12:05:02.433Z (8 months ago)
• Topics: absolute-humidity, absolute-luftfeuchte, airing, humidity-monitoring, lueft-app, lueften, luftfeuchtigkeit, temperature-monitoring, terminal-based, ventilation
• Language: Python
• Homepage:
• Size: 96.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


# Simple terminal-based airing app

Application that checks and displays if airing is needed (based on humidity and temperature).


It provides a quick overview to easily compare humidity inside and outside, so that the user knows whether to ventilate or not.


With:

- terminal output coloured accordingly to the airing suggestion for a quick overview

- optional summer mode to check whether it's cooler inside or outside to help cool down the rooms by airing

- threshold for relative humidity colouring to show if a room is too humid (e.g. > 60% relative humidity)

- minimum difference for airing suggestion (e.g. only suggest airing when the difference is grater than 10%) 

The sensors are self-build and programmed by a friend.

![screenshot of the terminal with the airing program running](screenshot_airing_app.jpg)

## Used hardware and software:

Raspberry Pi 4 with Debian GNU/Linux 11 (bullseye)


4.3" touchscreen (DSI)


Python version 3.11


## How to use it

The app runs in the terminal (or in an IDE). It's used by typing one of the letters mentioned by the program and then pressing enter.


The relative humidity of the rooms are coloured green (ok) or red (too humid) according to the threshold (e.g. 60%).


The airing suggestions are: green (no need to air), red (should be aired) and orange (if it's more humid outside).


For the summer mode, blue shows that rooms can/should be aired to cool down, orange marks that it's already cooler inside.

The thresholds and colours can be personalized by changing the code.


For use on the Raspberry Pi with touch display, I installed the keyboard "onboard" that pops up every time the cursor is set in a window where you can type (e.g. notepad, terminal, ...)


(More info here: https://www.industrialshields.com/blog/raspberry-pi-for-industry-26/touch-screen-configuration-kiosk-mode-virtual-keyboard-setup-249 )


With the help of a shell script and a desktop file, the program can be started directly by double-clicking on a desktop icon.


Please consider:

- a sensor outside is mandatory for the app to work!

- ensure that the IP-addresses (of the sensors and the computer/Raspberry Pi) are assigned permanently in the network

## What worked for me:

- make a **shell script** to start the python program (this is a text file which ends on .sh and which contains the code that normally would be typed in the terminal):


it contains the headline for the shell script, goes to the directory where the program file is and runs the program (python3 path_to_the_file/name_of_the_program.py)


for example in my case, the shell script contains:


\#! /usr/bin/bash


cd /home/ynodd/airingapp


python3 main.py


- make a **desktop** shortcut to be able to run the airing code with **double-click** on the desktop **icon**:


create a text file ending on .desktop and save it to the Desktop. It should contain something like this:


[Desktop Entry]


Name=Airing App


\#Comment=


Exec=/home/ynodd/airingapp/airing_shortcut.desktop


\#Icon=/usr/share/test.png


Terminal=true


Type=Application


(Take care that the .desktop and .sh file have the right **permissions** to run.)