README

A terminal clock, stopwatch and timer.

Installation

sudo apt install php composer
# or in arch: sudo pacman -S php composer
composer global require haydenwu/tclk:dev-main

The tclk binary will be available in ~/.config/composer/vendor/bin. You may want to add it to your PATH.

Updating

composer global update

Usage

Usage: tclk [options]

Options:
   -h, --help                show this help
   -c, --clock [timezone]    run in clock mode
   -s, --stopwatch           run in stopwatch mode
   -t, --timer <[[h:]m:]s>   run in timer mode
   -n, --now                 start the stopwatch/timer immediately
   -x, --left <left>         set left position
   -y, --top <top>           set top position
   -z, --size <size>         set size
   -f, --fg <color>          set foreground color
   -i, --fg-inactive <color> set fg color when stopwatch/timer is inactive

Running without options is equivalent to "tclk -c".

Parameter explanations:

• timezone: One of the supported timezone names, an offset value (+0200), or a timezone abbreviation (BST).
• color: an integer from 40 to 47, or from 100 to 107. See here for details.

Hotkeys

License

This program is licensed under the GNU General Public License, version 3. Check LICENSE or gnu.org for a copy of the license.