CALLISTO-SUNSCHEDULE(1)

✨ CALLISTO-SUNSCHEDULE ✨

okay bestie, gather round, because this little helper is about to filter your e-Callisto schedule like it's curating a playlist 💅 the manual name is callisto-sunschedule and it lives in section 1 of the General Commands Manual, iykyk.

🌸 NAME 🌸

callisto-sunschedule — filter an e-Callisto schedule file 🦋

🎀 SYNOPSIS 🎀

callisto-sunschedule configfile [ margin ]

💖 DESCRIPTION 💖

So here's the vibe: this helper program filters a base callisto(1) schedule that it reads from standard input, and the whole point is making it so callisto is only recording when the Sun is up ☀️ like, no cap, we're not out here recording the void. The filtered schedule gets printed to standard output. The first argument to the program is the callisto configuration file, and from that file it reads the geographical coordinates and the focuscode. 🗺️

If there's a second argument, that's your margin — the number of seconds that the day gets extended from both ends 🫶. Now listen, important lore: the sunrise and sunset times that actually get computed are the ones for the UTC date in question, not the next ones. That's gonna cause a small error, especially when the daylength is changing fast 😭, and that's literally what the margin argument is for — compensating for it. Five or ten minutes (300 or 600 seconds) should be a good value for this. 📏

Only schedule entries with the same focuscode as in the configuration file are ever printed, periodt. The filtering inserts a start action at sunrise, if the base schedule indicates that recording should be on at that time, and a stop action at sunset. 🌅 Base schedule entries in the sunrise-to-sunset timespan are all printed. Only entries with the overview action are printed in the sunset-to-sunrise timespan. 🌙

The sunrise and sunset times are computed with the Emacs calendar, so Emacs needs to be installed to use this program — yes, fr fr, that's the deal 🧚. See the comments at the start of the script for the rationale.

👑 heads up bestie: no Emacs, no sun calculations. that's the whole plot twist.

🌈 AUTHOR 🌈

Juha Aatrokoski <jha@kurp.hut.fi> — iconic, we stan 💜

🦋 SEE ALSO 🦋

• callisto(1)

and that's the whole page, babe! this one's from the callisto source, dated March 2011, so it's giving vintage but make it solar 🌞 thanks for reading, mwah 💖✨