timeutils: Time utilities

[ gpl, library, program, time ] [ Propose Tags ]

Please see the README on GitHub at https://github.com/jlamothe/timeutils#readme

[Skip to Readme]
Versions [faq] 0.1.0
Change log ChangeLog.md
Dependencies base (>=4.7 && <5), brick (>=0.47.1 && <0.48), microlens (>=0.4.10 && <0.5), time (>= && <1.9), timeutils, vty [details]
License GPL-3.0-only
Copyright Jonathan Lamothe
Author Jonathan Lamothe
Maintainer jlamothe1980@gmail.com
Category Time
Home page https://github.com/jlamothe/timeutils#readme
Bug tracker https://github.com/jlamothe/timeutils/issues
Source repo head: git clone https://github.com/jlamothe/timeutils
Uploaded by jlamothe at 2019-08-06T13:08:30Z
Distributions NixOS:0.1.0
Executables timeutils
Downloads 270 total (2 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Last success reported on 2019-08-06 [all 1 reports]


[Index] [Quick Jump]


Maintainer's Corner

For package maintainers and hackage trustees

Readme for timeutils-0.1.0

[back to package description]


Copyright (C) 2019 Jonathan Lamothe jlamothe1980@gmail.com

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Executive Summary

This package contains some simple time-based tools, and consists of two parts: a library, and an executable. The library should be fairly portable, and provides some simple timer/stopwatch functionality. The executanle is a simple console-based program built on top of the brick package, and as such, will presently only work on POSIX-compatible systems (sorry Windows users).


The library provides its functionalty through the Data.Time.Utils module, and is thoroughlly documented on Hackage.


This package provides the timeutils executable, a console-based program with a rudimentary user interface. It has two modes: stopwatch and countdown. You can toggle between these modes by pressing the <tab> key. The program can be exited with the <esc> key, the q key, or by hitting <ctrl-c>.

Stopwatch Mode

The following is a list of keys and their effects in stopwatch mode:

Key | Effect --- | ------ <space> | start/stop stopwatch l | start new lap r | reset stopwatch

Countdown Mode

The following is a list of keys and their effects in countdown mode:

Key | Effect --- | ------ n | new countdown <up>/<down> | select countdown <space> | start/stop selected countdown <del> | delete selected countdown r | reset selected countdown R | delete all countdowns d/D | increment/deincrement days in current countdown h/H | increment/deincrement hours in current countdown m/M | increment/deincrement minutes in current countdown s/S | increment/deincrement seconds in current countdown