tock

Digital clock for the terminal

TLDR

Display a centered 24-hour clock with seconds

$ tock -s -m -c

Custom color and font dimensions

$ tock -C [4] -W [3] -H [2]

Custom date format

$ tock -f "[%A, %B %d]"

SYNOPSIS

tock [options]

DESCRIPTION

tock is a digital clock for the terminal inspired by tty-clock. It supports customizable positioning, font sizing, 12/24-hour modes, color selection, seconds display, and date formatting.

PARAMETERS

-s, --second

Display seconds.

-m, --military

Use 24-hour (military) time format.

-c, --center

Center the clock in the terminal (overrides manual positioning).

-C, --color COLOR

Set the clock color using an ANSI value 0-7 (default: 2).

-x, --x X

Horizontal 0-indexed position of the clock's top-left corner (default: 0).

-y, --y Y

Vertical 0-indexed position of the clock's top-left corner (default: 0).

-W, --width WIDTH

Font width in characters per tile (default: 2).

-H, --height HEIGHT

Font height in characters per tile (default: 1).

-f, --format FORMAT

Custom date format string (default: "%F | %Z").

-h, --help

Display help information.

INTERACTIVE KEYS

Quit the clock.

Toggle seconds display.

Toggle 24-hour (military) time.

0-7

Change the ANSI color at runtime.

INSTALL

brew install tock

CAVEATS

UNIX only due to termios usage.

HISTORY

tock was created by nwtnni and is written in Rust.