Claude
9e1087f875
Adds weather-tag.sh, a small failure-safe helper that queries OpenWeather's free "Current weather" endpoint and prints one tag from a fixed vocabulary (thunderstorm, rain, rainshower, snow, snowstorm, fog, windy, cloudy, clear) or nothing on any failure. ambient-record.sh calls it just before each 30-minute chunk so the filename reflects conditions at the moment of capture, e.g. east-08-30-00-thunderstorm.m4a east-12-00-00-clear.m4a A foggy dawn no longer mislabels the sunny afternoon files. Off by default. Enable with WEATHER_ENABLED=true and an OPENWEATHER_API_KEY entry in .env; missing key / API error / disabled toggle all fall through to the un-tagged filename, never blocking the recorder.
88 lines
4.4 KiB
Bash
Executable File
88 lines
4.4 KiB
Bash
Executable File
#!/bin/bash
|
|
# weather-tag.sh — print a one-word weather tag for the current moment at
|
|
# (LATITUDE, LONGITUDE), using the OpenWeather "Current weather" endpoint.
|
|
#
|
|
# Output: a single lowercase word from this fixed vocabulary, or empty:
|
|
# thunderstorm rain rainshower snow snowstorm
|
|
# fog windy cloudy clear
|
|
#
|
|
# Used by ambient-record.sh to suffix each 30-minute chunk's filename so the
|
|
# file collection self-documents what the audio actually captured.
|
|
#
|
|
# Failure-safe: if WEATHER_ENABLED≠true, the API key is missing, the network
|
|
# is down, the API returns an error, or the response can't be parsed, this
|
|
# script prints NOTHING and exits 0. Callers MUST treat empty output as
|
|
# "no tag — fall back to the un-tagged filename". Never blocks the recorder.
|
|
#
|
|
# Required setup:
|
|
# 1. Sign up at https://openweathermap.org/api → free "Current weather" plan
|
|
# 2. Put the key in .env: OPENWEATHER_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxx
|
|
# 3. Confirm LATITUDE / LONGITUDE are set in .env (already needed by sunrise.py)
|
|
# 4. Flip WEATHER_ENABLED=true in sky-cam.conf
|
|
#
|
|
# Manual test: ./weather-tag.sh (prints e.g. "cloudy" or nothing)
|
|
|
|
set -uo pipefail # NOT -e: we want to swallow every failure into "no tag"
|
|
|
|
SCRIPT_DIR="$(dirname "$(realpath "$0")")"
|
|
source "$SCRIPT_DIR/sky-cam.conf" 2>/dev/null || exit 0
|
|
source "$SCRIPT_DIR/.env" 2>/dev/null || true
|
|
|
|
[ "${WEATHER_ENABLED:-false}" = "true" ] || exit 0
|
|
[ -n "${OPENWEATHER_API_KEY:-}" ] || exit 0
|
|
[ -n "${LATITUDE:-}" ] || exit 0
|
|
[ -n "${LONGITUDE:-}" ] || exit 0
|
|
|
|
# ── Fetch current conditions ─────────────────────────────────────────────────
|
|
# 5s connect / 8s total — must never delay the recorder noticeably.
|
|
url="https://api.openweathermap.org/data/2.5/weather?lat=${LATITUDE}&lon=${LONGITUDE}&appid=${OPENWEATHER_API_KEY}&units=metric"
|
|
resp=$(curl -s --connect-timeout 5 --max-time 8 "$url" 2>/dev/null) || exit 0
|
|
[ -n "$resp" ] || exit 0
|
|
|
|
# ── Parse condition ID + wind speed ──────────────────────────────────────────
|
|
# Condition codes: https://openweathermap.org/weather-conditions
|
|
# OpenWeather may return multiple entries in weather[]; the first is primary.
|
|
if command -v jq >/dev/null 2>&1; then
|
|
code=$(echo "$resp" | jq -r '.weather[0].id // empty' 2>/dev/null)
|
|
wind=$(echo "$resp" | jq -r '.wind.speed // 0' 2>/dev/null)
|
|
else
|
|
# Fallback parser if jq is missing — grabs the first "id":NNN it sees.
|
|
code=$(echo "$resp" | grep -oE '"id":[0-9]+' | head -n1 | grep -oE '[0-9]+')
|
|
wind=$(echo "$resp" | grep -oE '"speed":[0-9.]+' | head -n1 | grep -oE '[0-9.]+')
|
|
fi
|
|
|
|
[ -n "${code:-}" ] || exit 0
|
|
wind="${wind:-0}"
|
|
|
|
# ── Map condition code → tag (vocabulary documented at top of file) ──────────
|
|
# Group ranges follow OpenWeather's published condition-code table:
|
|
# 2xx thunder / 3xx drizzle / 5xx rain / 6xx snow / 7xx atmosphere / 800 clear / 80x clouds
|
|
tag=""
|
|
case "$code" in
|
|
2*) tag="thunderstorm" ;;
|
|
3*) tag="rainshower" ;; # drizzle = light shower
|
|
500|520|521|522|531) tag="rainshower" ;; # light / shower variants
|
|
501|502|503|504|511) tag="rain" ;; # moderate → extreme + freezing
|
|
600|601|612|613|615|616|620|621) tag="snow" ;;
|
|
602|622) tag="snowstorm" ;; # heavy snow / heavy shower snow
|
|
611) tag="snow" ;; # sleet
|
|
701|711|721|741|762) tag="fog" ;; # mist / smoke / haze / fog / ash
|
|
731|751|761|771) tag="windy" ;; # dust whirls / sand / dust / squall
|
|
781) tag="thunderstorm" ;; # tornado → reuse strongest tag
|
|
800) tag="clear" ;;
|
|
801) tag="clear" ;; # few clouds — still mostly clear
|
|
802|803|804) tag="cloudy" ;;
|
|
*) tag="" ;; # unknown code → no tag
|
|
esac
|
|
|
|
# Wind override: gusty conditions drown out other audio cues. If the base
|
|
# tag is clear/cloudy and wind ≥ 8 m/s (~18 mph), promote to "windy".
|
|
if [ "$tag" = "clear" ] || [ "$tag" = "cloudy" ]; then
|
|
# bash can't compare floats — strip the decimal for an integer check.
|
|
wind_int="${wind%.*}"
|
|
[ "${wind_int:-0}" -ge 8 ] 2>/dev/null && tag="windy"
|
|
fi
|
|
|
|
[ -n "$tag" ] && printf '%s' "$tag"
|
|
exit 0
|