https://github.com/fortio/tclock

Terminal Clock using Ansipixels library
https://github.com/fortio/tclock

Last synced: 2 months ago
JSON representation

Terminal Clock using Ansipixels library

• Host: GitHub
• URL: https://github.com/fortio/tclock
• Owner: fortio
• License: apache-2.0
• Created: 2025-07-28T16:01:33.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2025-07-29T02:53:31.000Z (2 months ago)
• Last Synced: 2025-07-29T02:59:16.687Z (2 months ago)
• Language: Go
• Size: 11.7 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![GoDoc](https://godoc.org/fortio.org/tclock/bignum?status.svg)](https://pkg.go.dev/fortio.org/tclock/bignum)

[![Go Report Card](https://goreportcard.com/badge/fortio.org/tclock)](https://goreportcard.com/report/fortio.org/tclock)

[![CI Checks](https://github.com/fortio/tclock/actions/workflows/include.yml/badge.svg)](https://github.com/fortio/tclock/actions/workflows/include.yml)

# tclock

Terminal Clock using Ansipixels library

`tclock` is a simple terminal/TUI clock (well for now just big numbers printer).

## Install

You can get the binary from [releases](https://github.com/fortio/tclock/releases)

Or just run

```

CGO_ENABLED=0 go install fortio.org/tclock@latest  # to install (in ~/go/bin typically) or just

CGO_ENABLED=0 go run fortio.org/tclock@latest  # to run without install

```

or even

```

docker run -ti fortio/tclock # but that's obviously slower

```

or

```

brew install fortio/tap/tclock

```

## Run

Move the mouse to place the clock, click to leave it there, click again to put it somewhere else.

Change the color, draw box around, etc.. with flags.

```sh

tclock help

```

```

flags:

  -24

        Use 24-hour time format

  -bounce int

        Bounce speed (0 is no bounce and normal mouse mode); 1 is fastest, 2 is slower, etc.

  -box

        Draw a simple rounded corner outline around the time

  -breath

        Pulse the color (only works for RGB)

  -color string

        Color to use RRGGBB or one of: none, red, brightred, green, blue, yellow, cyan, white, black (default "red")

  -color-box string

        Color box around the time

  -debug

        Debug mode, display mouse position and screen borders

  -inverse

        Inverse the foreground and background

  -no-blink

        Don't blink the colon

  -no-seconds

        Don't show seconds

```

```sh

$ tclock

```

```

         ╭────────────────────────────────────╮

         │      ━━      ━━   ━━      ━━   ━━  │

         │   ┃ ┃  ┃       ┃    ┃    ┃  ┃    ┃ │

         │          ::  ━━   ━━  ::           │

         │   ┃ ┃  ┃    ┃       ┃    ┃  ┃    ┃ │

         │      ━━      ━━   ━━      ━━       │

         ╰────────────────────────────────────╯

```