NAME

       callisto-sunschedule - Filter an e-Callisto schedule file

SYNOPSIS

       callisto-sunschedule configfile [ margin ]

DESCRIPTION

       This  helper  program  filters a base callisto(1) schedule, read from standard input, so that callisto is
       recording only when the Sun is up. The filtered  schedule  is  printed  to  standard  output.  The  first
       argument  to  the program is the callisto configuration file, from which the geographical coordinates and
       focuscode are read.

       If there is a second argument to the program, it is the number of seconds that the day is  extended  from
       both ends. The sunrise and sunset times actually computed are those for the UTC date in question, not the
       next ones. This will cause a small error, especially when the daylength is changing fast, and the  margin
       argument  can  be  used to compensate for this. 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.  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. See the comments at the start of the script for the rationale.

AUTHOR

       Juha Aatrokoski <jha@kurp.hut.fi>

SEE ALSO

       callisto(1)