Merge pull request #38 from outis1one/clDemoe/seasonal-sunrise-montage-nn268

Clarify .env vs sky-cam.conf split for toggles and private values

install.sh

@@ -280,10 +280,11 @@ env_example="$HERE/.env.example"
     echo "channel_id=your-daily-upload-channel-id-here"
     echo ""
     echo "# ── Notifications ───────────────────────────────────────────────────────────"
-    echo "# Also set NTFY_ENABLED=true / EMAIL_ENABLED=true / MM_NOTIFY_ENABLED=true"
+    echo "# Set the private values here, then flip the matching *_ENABLED toggle"
-    echo "# in sky-cam.conf to activate the method."
+    echo "# to true in sky-cam.conf."
     echo "#NTFY_URL=https://ntfy.sh/your-topic"
     echo "#EMAIL_TO=you@example.com"
+    echo "#EMAIL_FROM=skycam@localhost"
     echo "#MM_NOTIFY_CHANNEL_ID=your-notify-channel-id-here"
 } > "$env_example"
 echo "  wrote .env.example  (cp .env.example .env  then fill in real values)"

sky-cam.conf

@@ -158,13 +158,16 @@ MUSIC_DIR="${MUSIC_DIR:-$SCRIPT_DIR/music}"
 #   Google Maps — right-click your location → the first item shown is "lat, lon"
 #   Or: maps.google.com, drop a pin, coordinates appear in the URL and sidebar
 #
-# TIMEZONE must be a valid IANA name.  Look yours up at:
+# ── Location & timezone ───────────────────────────────────────────────────────
-#   https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+# Set your real values in .env — do not put exact coordinates here since
-#   (use the value in the "TZ identifier" column, e.g. America/Chicago)
+# this file is committed to git.  Add these three lines to your .env:
 #
-# Set your real values in .env — these placeholder defaults keep the file
+#   LATITUDE=43.1234
-# shareable without leaking your exact location.
+#   LONGITUDE=-76.5678
-LATITUDE="${LATITUDE:-25.0000}"
+#   TIMEZONE=America/Chicago
+#
+# Placeholder values below are used only if .env has not set them.
+LATITUDE="${LATITUDE:-0.0000}"
 LONGITUDE="${LONGITUDE:-0.0000}"
 TIMEZONE="${TIMEZONE:-America/New_York}"
 
@@ -336,19 +339,22 @@ AMBIENT_RETENTION_DAYS=30              # delete files older than this; 0 = keep
 # ntfy — push notifications, zero signup for self-hosted or free cloud tier:
 #   Self-hosted: https://docs.ntfy.sh/install/
 #   Cloud: pick any topic name at ntfy.sh (no account needed)
-NTFY_ENABLED="${NTFY_ENABLED:-false}"
+#   Set NTFY_URL=https://ntfy.sh/your-topic in .env, then flip the toggle below.
-NTFY_URL="${NTFY_URL:-}"               # set in .env — keeps your topic URL out of git
+NTFY_ENABLED=false
+NTFY_URL="${NTFY_URL:-}"
 
 # Email — requires the 'mail' command (package: mailutils or s-nail).
 # Configure outbound SMTP via /etc/ssmtp/ssmtp.conf or msmtp.
-#EMAIL_ENABLED=true
+#   Set EMAIL_TO and EMAIL_FROM in .env, then flip the toggle below.
-#EMAIL_TO=you@example.com
+EMAIL_ENABLED=false
-#EMAIL_FROM=skycam@localhost
+EMAIL_TO="${EMAIL_TO:-}"
+EMAIL_FROM="${EMAIL_FROM:-skycam@localhost}"
 
 # Mattermost text post — reuses mattermost_url and access_token above.
 # Can be the same daily channel or a separate admin/private channel.
-#MM_NOTIFY_ENABLED=true
+#   Set MM_NOTIFY_CHANNEL_ID in .env, then flip the toggle below.
-#MM_NOTIFY_CHANNEL_ID=your-notify-channel-id-here
+MM_NOTIFY_ENABLED=false
+MM_NOTIFY_CHANNEL_ID="${MM_NOTIFY_CHANNEL_ID:-}"
 
 # ── Credentials (.env override) ───────────────────────────────────────────────
 # Sensitive values (RTSP URLs with passwords, API tokens) can be kept out of