Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
TTY-CLOCK(1)			 User Commands			  TTY-CLOCK(1)

       tty-clock - a terminal digital clock

       tty-clock  [-iuvsScbtrahDBxn] [-C [0-7]]	[-f format] [-d	delay] [-a ns-
       delay] [-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.

       [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 dis-
	      abled 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 charac-
	      ter device to which the user has rw  access  permissions.	  (See

       -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. De-
	      fault 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  indefi-
       nitely  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

				 October 2013			  TTY-CLOCK(1)


Want to link to this manual page? Use this URL:

home | help