stl: time logger
A cli time logger. Diligently make logs when you switch on/off the working mode and it will dutifully do the arithmetics.
The time from the moment you do:
stl start lumberjacking
until the moment you do:
will be added to the time logs. Once your logs start piling up, you can fulfil your working hours curiousity:
stl show --task lumberjacking stl show --month october stl show --span 15 oct 5 dec
stl show --help for all the options, there are a few of these. The
data is stored in plaintext files in
~/.config/stl, safe to move around or
This is a standard Python 3 package without dependencies. You can install it through pip:
pip3 install stltimelogger
or, alternatively, you can clone this repo (safe to delete afterwards) and do:
python3 setup.py test python3 setup.py install
pip3 uninstall stltimelogger rm -r ~/.config/stl
Of course, all of that could be happening within a virtualenv/venv.
stl start makes a log that you start working. You can also add a task name
if you want to see stats about that particular task later on.
stl stop makes a log that you have stopped working.
stl show (also
stl status) shows you how far you are into your current
task when called without additional arguments. The latter might be:
stl show --day DAY(also
DAYcan be anything like:
15 oct 2016,
stl show --week WEEK(also
WEEKcan be either
stl show --month MONTH(also
MONTHcan be anything like:
stl show --year YEAR(also
YEARcan be anything like:
stl show --span SPAN(also
SPANcan be anything like:
15 25 oct,
15 oct 2016 25 oct 2016,
15. If you specify only one date, the second will be set to today; e.g.
stl show -s 1 octis the same as
stl show -m oct. The interval is inclusive at both ends.
stl show --task TASK(also
TASKis the name of a task you have prudently specified when you had been working on it.
stl add START STOP [TASK] allows you to cheat and add log entries for
arbitrary time intervals in the past and future.
stl edit WHAT opens the right file in your $EDITOR.
WHAT can be
anything which is a valid
stl show -m argument. As you might guess, logs
are stored in month files.
- timeflow: also in Python but somewhat different approach.
- taskwarrior: a great todo cli manager which includes time logging functionality as well.
MIT. Do as you please and praise the snake gods.