seanmceligot / iloveair

I Love Air

A collection of tools to compare indoor and outdoor temp and humidity and tell you when you can open your windows

Configuration Files

The tools utilize various configuration. All paths are configurable with command line options

• Airthings Configuration: ~/.config/iloveair/airthings.json

{
  "client_id": "",
  "client_secret": "",
  "device_id": ""
}

• Pushover Configuration: ~/.config/iloveair/pushover.json

{
  "api_key": "",
  "user_key": ""
}

• OpenWeatherMap Configuration: ~/.config/iloveair/openweathermap.json

{
  "api_key": "",
  "city": "",
  "country": "",
  "latitude": "",
  "longitude": ""
}

Cache Files

generated cache files. All paths are configurable with command line options

• Indoor Data: ~/.cache/iloveair/indoor.json
• Pollution Data: ~/.cache/iloveair/pollution.json
• Airthings Token: ~/.cache/iloveair/airthings_token.json
• Weather Data: ~/.cache/iloveair/weather.json
• Window State: ~/.cache/iloveair/open_windows.state

Commands

Get Weather

Fetches the current weather data:

cargo run --bin getweather -- --config $CONFIG_WEATHER --out $CACHE_WEATHER

Get Pollution

Fetches the current pollution data:

cargo run --bin getpollution -- --config $CONFIG_WEATHER --out $CACHE_POLLUTION

Read WavePlus

Reads data from the Airthings API:

cargo run --bin read_waveplus -- --config $CONFIG_AIRTHINGS --indoor $CACHE_INDOOR --token $CACHE_TOKEN

Notification

Tells you if you can open your windows based on indoor and outdoor temp and humidity

cargo run --bin weather_notify -- --pushover $CONFIG_PUSHOVER --weather $CACHE_WEATHER --indoor $CACHE_INDOOR --window $CACHE_WINDOW