tock

A digital clock for the terminal, inspired by tty-clock. Unfortunately only works on UNIX systems due to the use of the termios and sigaction related function calls.

Features

Screenshots

Screenshot of clock

asciicast of multiple clocks

Installation

Currently requires a Rust installation, and is only available from either:

  1. crates.io

$ cargo install tock

  1. Building from source

$ git clone https://github.com/nwtnni/tock.git $ cargo build --release $ ./target/release/tock

Usage

``` USAGE: tock [FLAGS] [OPTIONS]

FLAGS: -c, --center Center the clock in the terminal. Overrides manual positioning.

    --help
        Prints help information

-m, --military
        Display military (24-hour) time.

-s, --seconds
        Display seconds.

-V, --version
        Prints version information

OPTIONS: -C, --color Change the color of the time.

        Accepts either a [single 8-bit number][0] or three comma-separated 
        8-bit numbers in R,G,B format. Does not check if your terminal 
        supports the entire range of 8-bit or 24-bit colors.

        [0]: https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit [default: 2]

-h, --height <h>
        Font height in characters per tile. [default: 1]

-w, --width <w>
        Font width in characters per tile. [default: 2]

-x, --x <x>
        Horizontal 0-indexed position of top-left corner. [default: 1]

-y, --y <y>
        Vertical 0-indexed position of top-left corner. [default: 1]

```

References