clocks is a command line tool for displaying multiple clocks in your terminal. It allows you to configure multiple clocks and display them in a single view. You can give different timezone clocks different colors to allow for easy distinction. You can also configure your preferred layout.
You can install the latest version of clocks by running the following command in your terminal.
curl -fsSL https://raw.githubusercontent.com/prnvbn/clocks/main/installer.sh | bashor using wget:
wget -qO - https://raw.githubusercontent.com/prnvbn/clocks/main/installer.sh | bashMove the binary to a directory in your PATH. For e.g. /usr/local/bin on linux.
To enable autocomplete, add the following to your .bashrc or .bash_profile file:
# you can also generate completions for zsh and fish shells by replacing bash with zsh or fish
source <(clocks completion bash)NOTE: dont forget to restart your terminal or run
source ~/.bashrc
If you want use an alias for clocks, you can add the following to your .bashrc or .bash_profile file:
alias c=clocks
source <(clocks completion bash | sed 's/clocks/c/g')Windows installation instructions are a WIP. In the meantime, you can download the latest release from the releases page
Run clocks add and follow the prompts to add a clock.
You can edit a clock at any time by running clocks edit and following the prompts.
The clocks can be displayed by running clocks.
You can remove a clock by running clocks remove and following the prompts.
To list all clocks without the time, run clocks list.
Use the clocks layout comand to change the layout of the clocks.
-
Custom (Grid)
-
Custom (Centered)
To also see the seconds value, run clocks --seconds. To persist this setting, run clocks set --seconds. This setting can be reversed by running clocks unset --seconds.
To display the time in 12 hour format, run clocks --t12. To persist this setting, run clocks set --t12. This setting can be reversed by running clocks unset --t12.
Note that additional work to display AM/PM on the clock face as well
To keep the clocks running and updating in real time, run clocks --live. To persist this setting, run clocks set --live. This setting can be reversed by running clocks unset --live.
clocks is configured by a YAML file that will be auto-generated on first run. By default, the config file is assumed to exist on an XDG-compliant configuration path like ~/.config/clocks/config.yaml. If you would like to store it elsewhere, you may export a CLOCKS_CONFIG_PATH environment variable that specifies its path:
export CLOCKS_CONFIG_PATH="<NEW_CONFIG_PATH>"Sure, telling time in multiple places isn't rocket science. You could probably Google it or check your phone, however, I find this extremely annoying.
This annoyance is compounded when I am working on multiple projects simultaneously and monitoring different dashboards; thus leaving me with scarce screen real estate.
Feel free to open an issue or submit a pull request. I'm always open to suggestions and improvements :)