1- # Boring -- Weather & Time Display
1+ # Breeze -- Weather & Time Display
22
33A GTK-based weather and time display with animated Cairo backgrounds.
44Touch anywhere to temporarily show a configurable web page (e.g., a
@@ -10,6 +10,7 @@ seconds.
1010- Live weather from [ Open-Meteo] ( https://open-meteo.com/ ) (no API key needed)
1111- Animated backgrounds: sky gradient, sun, clouds, rain, snow
1212- Sunrise/sunset times
13+ - Location lookup by city name (geocoding via Open-Meteo)
1314- Touch/click to show a web page (WebKitGTK), auto-returns after 30s
1415- Fullscreen kiosk mode
1516
@@ -20,13 +21,13 @@ seconds.
2021``` bash
2122sudo apt install libgtk-3-dev libwebkit2gtk-4.1-dev libsoup-3.0-dev libcjson-dev
2223make
23- ./boring --lat 59.33 --lon 18.07 -f
24+ ./breeze -l Stockholm -f
2425```
2526
2627### Run with Docker
2728
2829``` bash
29- docker compose up boring
30+ docker compose up breeze
3031```
3132
3233Or standalone:
@@ -36,25 +37,29 @@ docker run --rm -it \
3637 --privileged \
3738 -v /dev/fb0:/dev/fb0 \
3839 -v /dev/tty1:/dev/tty1 \
39- -e LATITUDE=59.33 \
40- -e LONGITUDE=18.07 \
40+ -e LOCATION=Stockholm \
4141 -e WEB_URL=https://example.com \
42- ghcr.io/kernelkit/demo-boring :latest
42+ ghcr.io/kernelkit/breeze :latest
4343```
4444
4545## Command-Line Options
4646
4747```
48- Usage: boring [OPTIONS]
49-
50- -f, --fullscreen Run in fullscreen mode
51- --lat LATITUDE Latitude for weather (default: 59.3293)
52- --lon LONGITUDE Longitude for weather (default: 18.0686)
53- --url URL Web page URL shown on touch/click
48+ Usage: breeze [OPTIONS]
49+
50+ -f, --fullscreen Run in fullscreen mode
51+ -l, --location LOCATION City or Country,City (e.g., "Stockholm"
52+ or "Sweden,Stockholm"), geocoded via Open-Meteo
53+ --lat LATITUDE Latitude for weather (default: 59.3293)
54+ --lon LONGITUDE Longitude for weather (default: 18.0686)
55+ --url URL Web page URL shown on touch/click
56+ -h, --help Show this help message
5457```
5558
56- Environment variables ` LATITUDE ` , ` LONGITUDE ` , and ` WEB_URL ` are used
57- as fallbacks when command-line options are not given.
59+ Environment variables ` LATITUDE ` , ` LONGITUDE ` , ` LOCATION ` , and ` WEB_URL `
60+ are used as fallbacks when command-line options are not given.
61+
62+ Press Escape to exit.
5863
5964## Dependencies
6065
0 commit comments