2026-04-11 21:23:40 +02:00
2026-04-11 21:20:54 +02:00
2025-12-02 14:10:14 +01:00
2024-01-17 00:14:12 +01:00
2026-04-11 21:21:51 +02:00
2026-04-11 21:23:40 +02:00

tlock

demo

Fully customizable clock for the terminal. You can change the colors, the date and time format and you can even use multiples modes: clock, chronometer and timer.

What it does

  • Clock mode, with customizable date and time format
  • Chronometer mode, with lap logging
  • Timer mode
  • Debug mode (prints your configuration)

Next features

  • Customizable font
  • Hot reloadable config

Installation

$ cargo install --git https://git.pihkaal.me/pihkaal/tlock.git

How to use

# Help
$ tlock --help

# Clock mode
$tlock

# Debug mode (print current configuration)
$ tlock debug

# Chronometer mode
$ tlock chrono

# Timer mode
$ tlock timer 4h 12m 30s

Configuration

Configuration is stored under ~/.config/tlock/config, it is generated by the program if it doesn't exist.
You can regenerate this configuration at any time by running:

$ tlock --regenerate-default

You can use multiple configuration files thanks to the --config flag:

$ tlock --config /path/to/your/config

The configuration itself contains comments to help you understand how to customize it.

License

This project is MIT licensed.

Description
Fully customizable clock for the terminal
Readme MIT 363 KiB
Languages
Rust 100%