This is a simple tool that one can call on the CLI to act as either a timer, with a settable length of time, or a stopwatch. One simply needs to run the program with the timer or stopwatch options, and choose any options as needed, and the program will run on the command line until it's stopped with a CTRL + C or, in the case of the timer, the time runs out.

To use the timer function, just input the timer arg to timer.py and then use the --settime arg to set the length of time for the timer. The length of the timer can be seconds, hours, or minutes, and can be set with either the older HH:MM:SS notation (e.g. 01:05:00 for 1 hour, 5 minutes), or with the new h, m, s notation (e.g. 1h5m). Note that with the new notation method, one does not need to enter all elements of the timer, and can just enter what they need. So, for example, if one wanted a 30 second timer, they would have to enter 00:00:30 using the old notation, and 30s using the new format. Eventually, the older format may be deprecated in favor of the new one if it's favored.

The stopwatch method will simply start and upward counting timer to help track the length of time something takes. This method will run until the user presses CTRL + c to stop.

Any sound can be used for when one is using the timer function and time has expired. There are 3 sound files included for now as choices. However, one need only using the --tone argument and supply it with an MP3 file. This feature has not yet been fully tested, and so there may be some system specific and / or MP3 specific issues with playback.