grandfatherclock - report time acoustically
grandfatherclock [-v] [-f config-file] [-l lock-file] [-q] [-t HHMM]
[-c play-command] [-a device] [-g gain] [-p toll-count] [-d audio-dir]
[-1 audio-file] [-2 audio-file] [-3 audio-file] [-4 audio-file] [-h
grandfatherclock plays audio files to sound the nearest hour or quarter
as directed. Command line arguments and an optional configuration file
determine the location of the audio files, and the commands to play
them. The file is usually executed every hour or quarter hour by a
Options are set by reading an optional configuration file and then
modifying options set by command line arguments. No more than one
configuration file is read. The configuration file name is the first
of: the one named in the command line, the one named in the environment
variable, the first readable one named in the FILES section.
Specify a configuration file to read.
Specify a lock file whose presence inhibits execution.
-v Report debugging information.
-q Sound the nearest quarter hour.
AUDIO_DEVICE Write the audio files to this device.
PLAY_GAIN Set an overall gain available as %g in the play
PAUSE_BETWEEN_TOLLS If nonzero, after each count of tolls, pause
for an additional second.
PLAY_COMMAND This shell command plays the audio file %f with
gain %g to device %a.
AUDIO_DIRECTORY The relative addresses among the audio files are
relative to this directory.
Q1_FILE Play this file at the first quarter of the hour.
Q2_FILE Play this file at the half hour.
Q3_FILE Play this file at the third quarter of the hour.
Q4_FILE Play this file at the hour.
TOLL_FILE Play this file for each toll.
Display the latest options, keys, and defaults.
Play the nearest quarter hour and toll the hour if appropriate.
grandfatherclock -p 4
Toll the hour with a pause between each 4 tolls.
(Add) 0,15,30,45 * * * * grandfatherclock -q
Emulate a grandfather clock.
If set, read the configuration from this file. Command line
arguments override the settings in this file.
Personal configuration file
System wide configuration file
grandfatherclock is Copyright (C) 2000 by Dr. Robert J. Meier
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.