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'.

       Single-Instance Options:

       --replace
              Replace the already running gtimelog instance.

       --quit Tell an already-running gtimelog instance to quit.

       --toggle
              Show/hide the gtimelog window if already running.

       --ignore-dbus
              Do not check if gtimelog is already running (allows you to have multiple  instances
              running).

       Debugging Options:

       --debug
              Show debug information.

       --prefer-pygtk
              Try to use the (obsolete) pygtk library instead of pygi.

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