omarfishir/windrose

Windrose is a command line program that tells you which windows in your home to open for the best natural airflow. You tell it where you live, either by typing exact coordinates or searching by city name, and which directions your windows face, and it uses live weather data to recommend which windows to open for air to come in and which to open for air to flow out. The program looks up your location through Open-Meteo, a weather data website, and if you search by city and there are multiple matches, such as several cities named Springfield, it asks you to pick the right one from a list. Once it has your coordinates, it calls another Open-Meteo service to get the current wind direction and speed for that spot. Rather than working with an exact compass bearing, the program simplifies wind direction into eight sectors: north, northeast, east, southeast, south, southwest, west, and northwest, each covering 45 degrees. It does the same for your windows, based on which directions you say they face. It then compares the wind's sector to each window's sector and works out how close each window is to facing directly into the wind, since a window pointed straight at the wind lets in the most air. The window closest to facing the wind is recommended for air intake, and windows on the opposite side are recommended for air to exit. As an example, if the wind is blowing in from the north, the program would suggest opening north facing windows to let air in and south facing windows to let it flow out. The project was built in Python as a learning exercise, referencing the CS50 and CS50P coursework topics, and requires an internet connection since it depends on live weather API calls rather than offline data. Setup is a standard Python dependency install using pip and a requirements file.