Workday Music Greeter
On weekdays, automatically switch the home-music scene for the current time slot, fetch a matching GIF, and send a greeting email that embeds and attaches that GIF. Includes a cron installer for Mon–Fri scheduling. Use when the user wants automated workday music scene switching paired with themed greeting emails.
workday-music-greeter
Orchestrates three existing skills into one weekday routine:
- home-music — switches the whole-house music scene for the current slot.
- gifgrep — pulls a GIF that matches the scene mood.
- imap-smtp-email — sends a greeting email with the GIF embedded and attached.
A cron installer schedules it Monday–Friday at each scene's start hour.
Files
workday-music-greeter/
├── SKILL.md # this file
├── run.sh # main orchestrator (supports --dry-run and `auto`)
├── scenes.conf # scene | hour-start | gif-query | email-subject
├── install-cron.sh # registers Mon–Fri crontab entries
└── .env.example # required/optional env vars
Quick start
cp .env.example .env && $EDITOR .env # set WMG_MAIL_TO + SMTP_* creds
WMG_MAIL_TO=you@example.com ./run.sh morning --dry-run # preview, touches nothing
WMG_MAIL_TO=you@example.com ./run.sh auto # pick scene by current time
./install-cron.sh # schedule Mon–Fri
How it works
run.sh <scene>runs one scene.run.sh autoselects the scene whosehour-startis the latest one at/"before now (seescenes.conf).- Weekend guard: if
date +%u >= 6(Sat/Sun) it exits without acting. - The GIF is injected into the email HTML via
<img src>(the gifgrep URL) and, when a local download exists, attached via--attach. --dry-runprints every external call instead of executing it — use it to verify wiring before going live.
Customizing scenes
Edit scenes.conf (pipe-delimited):
morning|8|good morning coffee sunrise|🌅 Good morning — easing into the day
chill|12|relax lofi midday break|🍵 Midday reset — chill vibes on
focus|14|focus work productivity calm|🎯 Afternoon focus block
off|18|goodbye work done relax weekend|🔇 Wrapping up — music off
Scene names must match home-music scenes (morning, chill, party, off, …).
Re-run install-cron.sh after changing hours; it replaces its own tagged block idempotently.
Dependencies & honest limitations
| Dependency | Needed for | Notes |
|---|---|---|
home-music | live scene switch | macOS-only (AppleScript + Spotify + Airfoil). On non-macOS the scene switch is skipped with a warning; the rest still runs. |
gifgrep | matching GIF | If absent, the email is sent without a GIF. |
imap-smtp-email | sending mail | Requires SMTP creds in env/.env. Without them, sending fails (reported, not silently swallowed). |
crontab | scheduling | install-cron.sh uses the system user crontab. |
If a dependency or credential is missing, run.sh warns and degrades rather
than faking success. Always validate with --dry-run first.
Environment
See .env.example. Required: WMG_MAIL_TO. SMTP_* are consumed by the
imap-smtp-email sender. Optional overrides: WMG_GIF_DIR, WMG_SMTP_SCRIPT.
- Downloads
- 479All time
- Security audit
- Review
- Last updated
- 5mo ago
- Current version
- v1.0.0
- License
- MIT-0
