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.
- vi-style movement commands to set the position of the displayed clock. These commands have no effect when the centered option is set.
- Select a different color for displaying the clock.
- Toggles bewteen bold and normal colors.
- Toggles displaying a box around the clock. This option is disabled by default.
- Toggle the clock's position to centered. When set the movement commands are disabled.
- Set the clock to rebound along the edges of the terminal.
- Display seconds.
- Switch time output to the 12-hour format.
- Show seconds.
- Screensaver mode. tty-clock terminates when any key is pressed.
- Show box.
- Set the clock at the center of the terminal.
- -C [0-7]
- Set the clock color.
- Use bold colors.
- Set the hour in 12h format.
- 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)
- Do rebound the clock.
- -f format
- Set the date format as described in strftime(3).
- 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)
- Show tty-clock version.
- Show some info about tty-clock.
- Show usage information.
- Hide the date.
- 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:
9:2345:respawn:/usr/bin/tty-clock -c -n -T /dev/tty9