README

A terminal clock, stopwatch and timer.

Screenshot

Installation

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

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

Updating

composer global update

Usage

Usage: tcl [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 foreground color when stopwatch/timer is inactive

Running without options is equivalent to "tcl -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

Key	Action
`up` / `down` / `left` / `right`	Move position
`c`	Move to center
`-` / `=`	Increase/decrease size
`space`	Start/pause timer/stopwatch
`r`	Reset timer/stopwatch
`q`	Quit program

License

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

haydenwu / tcl

Maintainers

Details