TCLOCK(1) X Version 11 TCLOCK(1)
Release 4
NAME
tclock - display time of day
SYNOPSIS
tclock [-option ...]
DESCRIPTION
Tclock displays an analog clock with a transparent face.
OPTIONS
-background background-color
specify the color of the interior of the clock
-bg background-color
same as -background
-border border-color
specify the color of the clock border
-borderWidth border-width
specify the thickness of the border - this is used as the
line-width attribute of a graphics context, so a border width
of zero still results in a thin border. If you want no border
at all, make the border color the same as the background
color.
-display display-name
specify the name of the display to use
-geometry clock-geometry
specify the geometry of the clock. Note that the size
specification of this string will be ignored; see the -scale
option for changing the size of the clock.
-scale clock-size
specify the size of the clock as a scale of the normal size.
For example, -scale 0.5 results in a clock half the size of
the default (in width and height - one-fourth the size in
area), and -scale 2.5 results in a clock two and one-half
times larger.
-tickradius tick-distance
specify the distance of each tick from the center of the
clock. Specifying zero results in no tick marks. Note that
this is adjusted by the -scale option.
-ticksize tick-size
specify the radius of each tick mark. Note that this is
adjusted by the -scale option; however, ticks do not seem to
scale well, so if you regularly start up the clock at a
specific scaling amount, you may wish to fine-tune this
- 1 - Formatted: December 24, 2025
TCLOCK(1) X Version 11 TCLOCK(1)
Release 4
parameter for best results.
-width border-width
same as -borderWidth
-xrm miscellaneous-resource
specify a resource for which no command-line option exists.
This is most often used to disable the second hand by
specifying -xrm "Tclock.Second.Tip.Radius: 0".
RESOURCES
The resources equivalent to command-line options are
Tclock.geometry
Tclock.scale
Tclock.border
Tclock.background
Tclock.borderWidth
Tclock.tick.radius
Tclock.tick.size In addition, each hand of the clock is made up
of four points. You may specify the position of each of these
four points for each hand. The hand specifications are {hour,
minute, second}, and the point specifications are {tip, right,
middle, left}. Each point has two resources:
Tclock.hand.point.radius
Tclock.hand.point.offset The radius specifies the distance in
pixels of that points from the center of the clock. The offset
specifies the angle of that point as an offset in minutes
(sixtieths of a circle) from the "true" position of the hand.
Specifying a radius of zero for the tip of a hand disables that
hand. Note that after you have fine-tuned the shapes of the
hands, you can simply use the -scale option (or the .scale
resource) to get any size clock with hands of that shape, without
needing to adjust the radii of all those points.
SEE ALSO
oclock(1), xclock(1)
COPYRIGHT
Copyright (C) 1991 Rob Mayoff.
This program 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; either version 1, 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.
- 2 - Formatted: December 24, 2025
TCLOCK(1) X Version 11 TCLOCK(1)
Release 4
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
AUTHOR
Rob Mayoff (mayoff@ccwf.cc.utexas.edu)
- 3 - Formatted: December 24, 2025
