NAME

       gtimelog - minimal time logging application

SYNOPSYS

       gtimelog [options]

DESCRIPTION

       gtimelog provides a time tracking application to allow the user to track what they work on during the day
       and how long they spend doing it.

       Here's  how  it  works:  every  day, when you arrive to work, start up gtimelog and type "arrived".  Then
       start doing some activity (e.g. reading mail, or working on a task).  Whenever you stop doing an activity
       (either when you have finished it, or when you switch to working on something else), type the name of the
       activity into the gtimelog prompt.  Try to use the same text if you make several entries for an  activity
       (history  helps  here  — just use the up and down arrow keys).  The key principle is to name the activity
       after you've stopped working on it, and not when you've started.  Of course you  can  type  the  activity
       name upfront, and just delay pressing the Enter key until you're done.

       There  are  two  broad  categories  of  activities:  ones  that  count as work (coding, planning, writing
       proposals or reports, answering work-related email), and ones that  don't  (browsing  the  web  for  fun,
       reading  personal email, chatting with a friend on the phone for two hours, going out for a lunch break).
       To indicate which activities are not work related add two asterisks to the activity name:

          lunch **
          browsing slashdot **
          napping on the couch **

       If you want some activity (or non-activity)  to  be  completely  omitted  from  the  reports,  use  three
       asterisks:

          break ***

       gtimelog  displays all the things you've done today, calculates the total time you spent working, and the
       total time you spent "slacking".  It also advises you how much time you still have to work today to get 8
       hours of work done.  There are two basic views: one shows all the activities in chronological order, with
       starting and ending times, while another groups all entries with the same  into  one  activity  and  just
       shows the total duration.

       At the end of the day you can send off a daily report by choosing Report -> Daily Report.  A mail program
       (Mutt    in    a    terminal,    unless    you    have    changed   it   in   ~/.gtimelog/gtimelogrc   or
       ~/.config/gtimelog/gtimelogrc) will be started with all the activities listed in it.

       If you make a mistake and type in the wrong activity name, or just forget to  enter  an  activity,  don't
       worry.   gtimelog  stores  the  time  log  in  a  simple  plain  text  file  ~/.gtimelog/timelog.txt  (or
       ~/.local/share/gtimelog/timelog.txt).  Every line contains a timestamp and the name of the activity  that
       was  finished  at  the  time.  All other lines are ignored, so you can add comments if you want to — just
       make sure no comment begins with a timestamp.  You do not have to worry about gtimelog  overwriting  your
       changes — gtimelog always appends entries at the end of the file, and does not keep the log file open all
       the  time.   You do have to worry about overwriting changes made by gtimelog with your editor — make sure
       you do not enter any activities in gtimelog while you have timelog.txt open in a text editor.

OPTIONS

       --version
              Show program's version number and exit.

       -h, --help
              Show this help message and exit.

       --tray Start minimized.

       --sample-config
              Write a sample configuration file to 'gtimelogrc.sample'.

       --debug
              Show debug information.

FILES

       ~/.gtimelog/gtimelogrc
       ~/.config/gtimelog/gtimelogrc

          Configuration file, see gtimelogrc(5).
       ~/.gtimelog/timelog.txt
       ~/.local/share/gtimelog/timelog.txt

          Activity log file.  Each line contains an ISO-8601 timestamp (YYYY-MM-DD HH:MM:SS) followed by  a  ":"
          and  a  space, followed by the activity name.  Lines are sorted chronologically.  Blank lines separate
          days.  Lines starting with # are comments.
       ~/.gtimelog/tasks.txt
       ~/.local/share/gtimelog/tasks.txt

          Tasks to be shown in the task pane.  Each line is either "task name" or "category: task  name",  lines
          starting with a # are comments.
       ~/.gtimelog/remote-tasks.txt
       ~/.local/share/gtimelog/remote-tasks.txt

          Tasks  to  be  shown  in  the  task  pane, when remote_task_url is set.  Contains a downloaded copy of
          whatever is at that URL.

SEE ALSO

       gtimelogrc(5)

AUTHOR

       Marius Gedminas <mgedmin@gedmin.as>

COPYRIGHT

       Marius Gedminas

0.10                                               2014-03-19                                        GTIMELOG(1)