Content-type: text/html Man page of CLOCKALRM


Section: User Commands (1)
Updated: 5 October 2001
Index Return to Main Contents


clockalrm - analogue (alarm) clock on text console  


clockalrm OPTIONS  


clockalrm Shows analogue time on a text terminal.  


-a ..., --alarm=MINUTES[:SECONDS]
Sound alarm minutes/seconds before termination.
-b, --bell-no
Silent alarm.
-c, --countdown
Show analogue countdown clock.
-C, --countdown-digital
Digital countdown [YEARS:[DAYS:]]HOURS:MINS:SECS. Displays YEARS as exactly 365 * 24 * 60 * 60-seconds intervals to go, not calender-years (an average calender-year is about 365.256 24h-days).
-d ..., --date=DATE
Terminate at date/time. If a timezone is present (see below) date/time is relative to it. DATE can be given in formats (`.' can be any character, YMDHMS must be 0-9):

DD-MM.YYYY.HH.MM.SS (day-month-year hour:minutes:seconds)
MM/DD.YYYY.HH.MM.SS (month/day/year hour:minutes:seconds)
HH.MM.SS (hour:minutes:seconds) Assumes present day.

-e, --exit
Print perceptions of time, then exit (debugging).
-f, --fixed
Use `H', `m', `s' to print clock arms.
-g, --graphic
Print arms ASCII-art style.
-h, --help
Print usage.
-j ..., --set-colors=COLOR[,COLOR[,COLOR[,...]]]
Define colors list for the clock. Argument expects pairs of colors, first foreground then background. These pairs are ordered: hour-arm,, minute-arm,, second-arm,, second-alarm-arm,, medal-background,. Colors can be: black, blue, cyan, green, magenta, red, white, yellow, or `nop'. `nop' does not alter the given color.

Example: --set-colors=cyan,green,cyan,red,cyan,magenta,red,black,black,blue

-k ..., --sec-color=COLOR
Change color of second arm to black, blue, cyan, green, magenta, red, white, yellow.
-K ..., --sec-color-alarm=COLOR
Change color of second arm during alarm to black, blue, cyan, green, magenta, red, white, yellow.
-l, --little
Smaller clock.
-m, --medal
Creates visible clock backdrop: sets erase character to `.' and sets foreground color of backdrop to blue. See --print and --set-colors for more control.
-n, --no-sec-arm
No seconds arm.
-o ..., --offset=MINUTES[:SECONDS]
Apply offset to --date option; positive for to the future, negative towards the present. If no --date option, relative to the present.
-p ..., --print=123[4]
Character to print when not in --graphic mode for 1) hour, 2) minute, 3) second arm. 4) for the background, 4) also applies in --graphic mode.

`--print=empty' equals '--print=    '
`--print=fizzz' equals '--print=@^ ^_' --set-colors=nop,nop,nop,nop,nop,nop,nop,nop,green,nop
`--print=knitted' equals --print=XXXX --set-colors=nop,nop,nop,nop,yellow,nop,yellow,nop,red,nop
`--print=knitted2' equals --print=XXXX --set-colors=nop,nop,nop,nop,cyan,nop,cyan,nop,blue,nop
`--print=nomedal' equals --set-colors=nop,nop,nop,nop,nop,nop,nop,nop,black,black
`--print=normal' equals '--print=Hms '
`--print=shade' equals '--print=\/ /' --set-colors=nop,nop,nop,nop,nop,nop,nop,nop,magenta,nop
`--print=simple' equals '--print=    ' --set-colors=blue,green,blue,red,blue,magenta,red,black,black,blue
`--print=terse' equals '--print=... ' --sec-color blue
`--print=wakeup' equals '--print=    ' --set-colors=red,black,red,black,black,black,black,magenta,white,black --when-no

Print week day name and month day number inside the clock, wrist-watch style.
-s ..., --sleep=SECONDS
Let program sleep between sampling time, this also affects the beeps of --alarm. Default is 1 second, 0 may produce curious alarms (and high program load).
-t ..., --text=TEXT
Display text in upper/left corner.
-u, --utc, --gmt
Use UTC/GMT, instead of local time.
-v, --version
Print version
-w, --when-short
Always print time in HH:MM:SS format.
-W, --when-full
Always print time in words/numbers, complete date.
-0, --when-no
Never print time in words/numbers.
-x, --am-pm
Print AM, PM.
-z ..., --zone=HOURS[:MINUTES[:SECONDS]]
Give a current time offset. When clockalrm runs in local time (no --gmt, --utc or -u argument), the offset is applied to local time and follows local daylight savings time.
-Z, --zero
Give timezone offset causing the present to be 1 Jan 1970 00:00:00, beginning of Epoch (count-up clock).


Seems to work, but is not completely tested.  




You are free to copy under the terms of the GNU General Public License.

Clockalrm 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; 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, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA




This document was created by man2html, using the manual pages.
Time: 13:51:07 GMT, July 05, 2007