tty-clock - a terminal digital clock
tty-clock [-iuvsScbtrahDBxn] [-C [0-7]] [-f
format] [-d delay] [-a nsdelay]
[-T tty]
tty-clock displays a simple digital clock on the terminal.
Invoked without options it will display the clock on the upper left corner
of the screen on the terminal it was executed from.
tty-clock accepts a number of runtime keyboard commands,
upper and lower case characters are treated identically.
- K,J,H,L
- vi-style movement commands to set the position of the displayed clock.
These commands have no effect when the centered option is set.
- [0-7]
- Select a different color for displaying the clock.
- B
- Toggles bewteen bold and normal colors.
- X
- Toggles displaying a box around the clock. This option is disabled by
default.
- C
- Toggle the clock's position to centered. When set the movement
commands are disabled.
- R
- Set the clock to rebound along the edges of the terminal.
- S
- Display seconds.
- T
- Switch time output to the 12-hour format.
- Q
- Quit.
- -s
- Show seconds.
- -S
- Screensaver mode. tty-clock terminates when any key is pressed.
- -x
- Show box.
- -c
- Set the clock at the center of the terminal.
- -C [0-7]
- Set the clock color.
- -b
- Use bold colors.
- -t
- Set the hour in 12h format.
- -u
- Use UTC time.
- -T tty
- Display the clock on the given tty. tty must be a valid
character device to which the user has rw access permissions. (See
EXAMPLES)
- -r
- Do rebound the clock.
- -f format
- Set the date format as described in strftime(3).
- -n
- Do not quit the program when the Q key is pressed (or when any key is
pressed while in Screensaver mode). A signal must be sent to
tty-clock in order to terminate its execution. (See
EXAMPLES)
- -v
- Show tty-clock version.
- -i
- Show some info about tty-clock.
- -h
- Show usage information.
- -D
- Hide the date.
- -B
- Enable blinking colon.
- -d delay
- Set the delay (in seconds) between two redraws of the clock. Default
1s.
- -a nsdelay
- Additional delay (in nanoseconds) between two redraws of the clock.
Default 0ns.
To invoke tty-clock in screensaver mode with the clock
display set to rebound and the update delay set to 1/10th of a second (10
FPS):
- $ tty-clock -Sra 100000000 -d 0
The following example arranges for tty-clock to be
displayed indefinitely on one of the Virtual Terminals on a Linux system at
boot time using an inittab(5) entry:
- # /etc/inittab:
9:2345:respawn:/usr/bin/tty-clock -c -n -T /dev/tty9