tdc1

Usage

Overview

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.