diff --git a/sky-cam.conf b/sky-cam.conf index 591546c..57b1d4a 100644 --- a/sky-cam.conf +++ b/sky-cam.conf @@ -72,8 +72,76 @@ # Helpers (called by the scripts above, not run directly): # notify.sh — sends notifications via ntfy / email / Mattermost # season_info.py — outputs astronomical season/movement/year for a date -# sunrise.py — outputs today's sunrise time (used by sunrise_video) +# sunrise.py — outputs today's sunrise time (used by daily_sunrise_video) # sunrise2mm.py — uploads the sunrise video to Mattermost +# sunrise_overlay.py — burns a timestamp overlay onto the sunrise video +# +# ----------------------------------------------------------------------------- +# FILE DEPENDENCIES — who calls whom, and what to update if you rename a file +# ----------------------------------------------------------------------------- +# +# sky-cam.conf (this file) +# ← sourced by every .sh script; read by sunrise.py, sunrise2mm.py +# → if renamed: update the 'source' line at the top of ALL scripts +# (don't rename it — just edit it in place) +# +# install.sh +# ← run manually; reads this conf +# → if renamed: update the note at the top of this conf file only +# generates → systemd unit files (sky-cam-*.service / .timer) +# and sky-cam-notify-failure@.service +# +# daily_sunrise_video.sh +# ← called by systemd sky-cam-sunrise.timer (09:00) +# → if renamed: update install.sh (write_service call, line ~80) +# then re-run install.sh to regenerate the unit +# calls → sunrise.py, sunrise_overlay.py, sunrise2mm.py +# +# 4-seasons.sh +# ← called by systemd sky-cam-4seasons.timer (01:00) +# → if renamed: update install.sh (write_service call, line ~86) +# then re-run install.sh +# calls → season_info.py, montage-mvt.sh +# +# fullday-video.sh +# ← called by systemd sky-cam-fullday.timer (02:00) +# → if renamed: update install.sh (write_service call, line ~93) +# then re-run install.sh +# +# montage-mvt.sh +# ← called by 4-seasons.sh on the last day of each movement +# → if renamed: update 4-seasons.sh (the exec line near the bottom) +# calls → season_info.py, notify.sh, year-end-join.sh +# +# year-end-join.sh +# ← called by montage-mvt.sh at end of Autumn Mvt 3 +# → if renamed: update montage-mvt.sh (the exec line at the bottom) +# calls → notify.sh +# +# notify.sh +# ← called by montage-mvt.sh, year-end-join.sh +# also referenced in install.sh for the OnFailure= failure template +# → if renamed: update montage-mvt.sh, year-end-join.sh, install.sh +# +# season_info.py +# ← called by 4-seasons.sh and montage-mvt.sh +# → if renamed: update 4-seasons.sh and montage-mvt.sh (the eval lines) +# +# sunrise.py +# ← called by daily_sunrise_video.sh +# → if renamed: update daily_sunrise_video.sh +# +# sunrise_overlay.py +# ← called by daily_sunrise_video.sh +# → if renamed: update daily_sunrise_video.sh +# +# sunrise2mm.py +# ← called by daily_sunrise_video.sh +# → if renamed: update daily_sunrise_video.sh +# +# stitch-cameras.py +# ← run manually only; no script calls it +# → safe to rename with no other changes needed # # =============================================================================