NAME¶
tty-clock - a terminal digital clock
SYNOPSIS¶
tty-clock [-sSbctrvih] [-C [0-7]] [-f format] [-d
delay] [-T tty]
DESCRIPTION¶
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.
COMMANDS¶
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 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.
OPTIONS¶
- -s
- Show seconds.
- -S
- Screensaver mode. tty-clock terminates when any key is pressed.
- -b
- Show box.
- -c
- Set the clock at the center of the terminal
- -C [0-7]
- Set the clock color.
- -t
- Set the hour in 12h format.
- -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 delay
- Set the delay (in nanoseconds) between two redraws of the clock.
EXAMPLES¶
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 -Srd 100000000
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
AUTHORS¶
Written by Martin Duquesnoy <xorg62@gmail.com>.
manpage written by Carla Valenti <valenti.karla@gmail.com>.
Please report
tty-clock bugs to
xorg62@gmail.com