NAME¶

tdc - stand alone clock that is designed to run as a dock application but is not required to

SYNOPSIS¶

tdc [options]

DESCRIPTION¶

Tiny Dockable Clock (tdc) is a simple and tiny dockable clock.

TDC is a stand-alone clock to X Window Systemd/X11 (e.g. XOrg or XFree86). It has minimal build and run-time dependencies. TDC works with virtually any EWMH-compliant window manager.

The behavior and the look of TDC can be configured either via command line options or via configuration file. As usual, command-line options have precedence over options that are specified in the configuration file.

OPTIONS¶

This program follows the usual command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-t, --font

The font face to use. Default is Mono.

-b, --bold

Use a bold font.

-s, --fontsize

The font size to use. Default is 12.0.

-c, --color

The font color to use. Default is white.

-w, --width

The width of the dockapp window. Default is 64.

-f, --format

The time format to use. Default is %T. You can get format codes from the man page for strftime.

--enable-cal

Enable the calendar feature which is opened by clicking the clock.

--calfont

The font that will be used in the calendar. Default is Mono.

--calfontsize

The font size used in the calendar. Default is 14.0.

--hlcolor

The highlight color to use in the calendar. Default is grey30.

-h, --help

Show help information and exit.

-v, --version

Show version information and exit.

XDEFAULTS¶

The following options can be set in $HOME/.Xdefaults:

tdc*font
tdc*bold
tdc*fontsize
tdc*enable-cal
tdc*calfont
tdc*calfontsize
tdc*color
tdc*hlcolor
tdc*width
tdc*format

EXAMPLES¶

These are some samples you may be interested in.

tdc --width 110 --format "%x %H:%M"
tdc --width 130 --format "%x %H:%M:%S"
tdc --width 230 --format "%a, %d %b %Y %T %z"
tdc -w 110 -f "%x %H:%M" --enable-cal --hlcolor=grey40

FILES¶

$HOME/.Xdefaults — Specify defaults for tdc to refer to. This is discussed above.

BUGS¶

If you experience bugs, the best way to report them is to the upstream bug tracker. This can be found at https://github.com/MTecknology/tdc/issues.

This manual page was written by Michael Lustfield <michael@lustfield.net>.