logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

wmwork - keep track of time worked on projects

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>

The Debian Project                                 March 2024                                          WMWORK(1)

Bugs

       Please send any bugs to <BUG-REPORT-ADDRESS>. Debian users are encouraged to use the Debian Bug  Tracking
       System <http://bugs.debian.org/wmwork>.

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  Worklogwmwork  is  a
       graphical  application  designed  to  work  with  the  WindowMaker  dock, but will work with other window
       managers as well.

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.

Name

       wmwork - keep track of time worked on projects

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.

Synopsis

wmwork [options]

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.

See Also