{"id":25264865,"url":"https://github.com/ynodd/simple-terminal-based-airing-app","last_synced_at":"2025-10-09T12:05:04.215Z","repository":{"id":275971897,"uuid":"927774085","full_name":"YNodd/simple-terminal-based-airing-app","owner":"YNodd","description":"App that compares inside and outside values and shows whether airing is needed, based on humidity and temperature","archived":false,"fork":false,"pushed_at":"2025-03-03T11:46:20.000Z","size":99,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-09T12:05:02.433Z","etag":null,"topics":["absolute-humidity","absolute-luftfeuchte","airing","humidity-monitoring","lueft-app","lueften","luftfeuchtigkeit","temperature-monitoring","terminal-based","ventilation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YNodd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-05T14:22:09.000Z","updated_at":"2025-03-03T11:46:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"fd40f932-c8c8-4b4c-a661-b0196bf28e65","html_url":"https://github.com/YNodd/simple-terminal-based-airing-app","commit_stats":null,"previous_names":["ynodd/simple-terminal-based-airing-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/YNodd/simple-terminal-based-airing-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YNodd%2Fsimple-terminal-based-airing-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YNodd%2Fsimple-terminal-based-airing-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YNodd%2Fsimple-terminal-based-airing-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YNodd%2Fsimple-terminal-based-airing-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YNodd","download_url":"https://codeload.github.com/YNodd/simple-terminal-based-airing-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YNodd%2Fsimple-terminal-based-airing-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001441,"owners_count":26083078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["absolute-humidity","absolute-luftfeuchte","airing","humidity-monitoring","lueft-app","lueften","luftfeuchtigkeit","temperature-monitoring","terminal-based","ventilation"],"created_at":"2025-02-12T07:48:09.421Z","updated_at":"2025-10-09T12:05:04.201Z","avatar_url":"https://github.com/YNodd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n# Simple terminal-based airing app\n\nApplication that checks and displays if airing is needed (based on humidity and temperature).\u003cbr\u003e\nIt provides a quick overview to easily compare humidity inside and outside, so that the user knows whether to ventilate or not.\u003cbr\u003e\n\nWith:\n- terminal output coloured accordingly to the airing suggestion for a quick overview\n- optional summer mode to check whether it's cooler inside or outside to help cool down the rooms by airing\n- threshold for relative humidity colouring to show if a room is too humid (e.g. \u003e 60% relative humidity)\n- minimum difference for airing suggestion (e.g. only suggest airing when the difference is grater than 10%) \n\nThe sensors are self-build and programmed by a friend.\n\n![screenshot of the terminal with the airing program running](screenshot_airing_app.jpg)\n\n## Used hardware and software:\nRaspberry Pi 4 with Debian GNU/Linux 11 (bullseye)\u003cbr\u003e\n4.3\" touchscreen (DSI)\u003cbr\u003e\nPython version 3.11\u003cbr\u003e\n\n## How to use it\nThe 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.\u003cbr\u003e\nThe relative humidity of the rooms are coloured green (ok) or red (too humid) according to the threshold (e.g. 60%).\u003cbr\u003e\nThe airing suggestions are: green (no need to air), red (should be aired) and orange (if it's more humid outside).\u003cbr\u003e\nFor the summer mode, blue shows that rooms can/should be aired to cool down, orange marks that it's already cooler inside.\nThe thresholds and colours can be personalized by changing the code.\u003cbr\u003e\n\nFor 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, ...)\u003cbr\u003e\n(More info here: https://www.industrialshields.com/blog/raspberry-pi-for-industry-26/touch-screen-configuration-kiosk-mode-virtual-keyboard-setup-249 )\u003cbr\u003e\n\nWith the help of a shell script and a desktop file, the program can be started directly by double-clicking on a desktop icon.\u003cbr\u003e\n\nPlease consider:\n- a sensor outside is mandatory for the app to work!\n- ensure that the IP-addresses (of the sensors and the computer/Raspberry Pi) are assigned permanently in the network\n\n## What worked for me:\n- 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):\u003cbr\u003e\nit 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)\u003cbr\u003e\nfor example in my case, the shell script contains:\u003cbr\u003e\n\\#! /usr/bin/bash\u003cbr\u003e\ncd /home/ynodd/airingapp\u003cbr\u003e\npython3 main.py\u003cbr\u003e\n- make a **desktop** shortcut to be able to run the airing code with **double-click** on the desktop **icon**:\u003cbr\u003e\ncreate a text file ending on .desktop and save it to the Desktop. It should contain something like this:\u003cbr\u003e\n[Desktop Entry]\u003cbr\u003e\nName=Airing App\u003cbr\u003e\n\\#Comment=\u003cbr\u003e\nExec=/home/ynodd/airingapp/airing_shortcut.desktop\u003cbr\u003e\n\\#Icon=/usr/share/test.png\u003cbr\u003e\nTerminal=true\u003cbr\u003e\nType=Application\u003cbr\u003e\n\n(Take care that the .desktop and .sh file have the right **permissions** to run.)\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fynodd%2Fsimple-terminal-based-airing-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fynodd%2Fsimple-terminal-based-airing-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fynodd%2Fsimple-terminal-based-airing-app/lists"}