tlock

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

What it does

Clock mode, with customizable date display
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.

1.3 KiB Raw Blame History