123vivekr / timers

A deep-work tracker in your command line.

timers

A countdown timer for your command line.

Features

• Simple notation
• Countdown display
• Timer end notification
• Log usage to output file

Usage

Set countdown for 1 minute

$ timers 1m

Set countdown for 1 second

$ timers 1s

Set countdown for 1 hour

$ timers 1h

Log usage to output file

$ timers -o log.txt 10s

Log format: timer_set,start_date,end_date

start_date and end_date in RFC3339 format.

For more granular control, you can combine units. To set countdown for 10 minutes and 30 seconds,

timers 10m30s

timers's Issues

Log incomplete sessions

Currently it only logs completed sessions. If I Ctrl+C, I need to log that too

Parse arguments and environment variables

A few random ideas from the top of my head:

• Would be nice to just run timers and start a stopwatch. (Right now it only functions as a countdown timer)
• Disable timer end notification (with an argument or an environment variable)

Time drift

The countdown output is in seconds. But perhaps you did experiment with the units, and found out the time drift caused by the linear sequence of operations. This time drift, although minute, will add up to significant amounts when the timer is set to a high value, like 5 minutes or so.

Here is the output for elapsed time (in milli seconds):

1000
2000
3001
4001
5001
6002
7002
8003
9003
10004

Press space to pause

Display usage statistics

Would be good to have a UI to show usage statistics read from the log file.
We could use something like tui-rs

Log session into file

I use this to track time but I also want to store the tracking information in a file for later analysis. It would be useful to have timers output to a time log file about the timer sessions. The start time, end time and the date would be useful to have. And this output to file functionality could be toggled on by using some flag --track.

WebUI console

We could have a desktop app + web UI which could

• control the timer
• show usage statistics

To explore:

• Tauri or WRY
• Web application

Press r to restart

The only way to restart the timer right now is to kill the application and then run it again.
It would be a nice touch to have the timer restart whenever the user presses the 'r' key.

A possible solution involves running a separate thread that waits for user input and restarts the timer whenever an 'r' character is recevied.