xenial (1) gtimelog.1.gz

Provided by: gtimelog_0.10.0-1_all bug

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>


       Marius Gedminas