NAME¶
wmwork - keep track of time worked on projects
SYNOPSIS¶
wmwork [
options]
DESCRIPTION¶
wmwork provides a monitor on a 64x64 mini window that helps you keeping
track of your time. The idea is based on the program
Worklog written by
Truxton King Fulton II. In contrast to
Worklog wmwork is a
graphical application designed to work with the WindowMaker dock, but will
work with other window managers as well.
OPTIONS¶
- -d, --days
- displays time in ddd.hh:mm instead of hhh:mm:ss. Note that if one timer is
at least 1000 hours large this will be the case anyway.
- -f, --force
- overwrite stale lock files. Use this if wmwork says that it's
already running but it isn't.
- -h, --help
- display a command line summary.
- -v, --version
- display the version number.
- --display=id
- set the display to use, e.g. --display=:0.0.
- --geometry=pos
- set the position of the dock app, e.g. --geometry=+10+10. Note that
the size (64x64) is hard-coded and cannot be changed.
USAGE¶
When
wmwork is started, the uppermost line shows the accumulated time
spent on the project, identified by a three letter code in the third line. The
second line shows the current time spent on the project and is initially zero.
The button
V starts the timer, the button
|| pauses it. The button
X stops the timer, saving the accumulated time in
~/.wmwork/worklog, adding the current session time to
~/.wmwork/worklog.XYZ and resetting the latter.
The buttons
< and
> switch between the projects found in the
file
~/.wmwork/worklog. This can be done only if the timer is neither
running nor paused.
FILES¶
- ~/.wmwork/worklog
- contains the projects configuration and log summaries.
Each line has the form
identifier:timestamp[:comment]. Empty lines and
lines beginning with a
# are ignored. Only the first three characters
of the (case-insensitive) identifier are relevant. When
wmwork is
overwriting
~/.wmwork/worklog it cuts the identifiers down that way.
- ~/.wmwork/???
- contains human readable timestamps for the project XYZ, where
XYZ is the truncated identifier from ~/.wmwork/worklog.
Having multiple entries of the same identifier in
~/.wmwork/worklog is
possible. They are counted independently, but will share the same project
file.
BUGS¶
Please send any bugs to <martin@godisch.de>. Debian users are encouraged
to use the Debian Bug Tracking System <
http://bugs.debian.org/wmwork>.
AUTHOR¶
wmwork was written by Martin A. Godisch <martin@godisch.de>. It is
based on the program wmppp written by Martijn Pieterse and Antoine Nulle.
Thanks to the following people, who have contributed to wmwork:
Adam Lackorzynski <adam@os.inf.tu-dresden.de>
Gordon Fraser <gordon@freakzone.net>
Daniel Tschan <tschan@devzone.ch>
Alexey Dokuchaev <danfe@danfe.ru>
Josep Portella Florit <jpf@sdf.lonestar.org>
Ben Stern <ben.stern@gmail.com>