.\" Man page generated from reStructuredText. . .TH GTIMELOG 1 "2014-03-19" "0.10" "" .SH NAME gtimelog \- minimal time logging application . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .SH SYNOPSYS .sp \fBgtimelog\fP [options] .SH DESCRIPTION .sp \fBgtimelog\fP 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. .sp Here\(aqs how it works: every day, when you arrive to work, start up \fBgtimelog\fP 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 \fBgtimelog\fP 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\(aqve stopped working on it, and not when you\(aqve started. Of course you can type the activity name upfront, and just delay pressing the Enter key until you\(aqre done. .sp 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\(aqt (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: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C lunch ** browsing slashdot ** napping on the couch ** .ft P .fi .UNINDENT .UNINDENT .sp If you want some activity (or non\-activity) to be completely omitted from the reports, use three asterisks: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C break *** .ft P .fi .UNINDENT .UNINDENT .sp \fBgtimelog\fP displays all the things you\(aqve 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. .sp At the end of the day you can send off a daily report by choosing \fBReport \-> Daily Report\fP\&. A mail program (Mutt in a terminal, unless you have changed it in \fB~/.gtimelog/gtimelogrc\fP or \fB~/.config/gtimelog/gtimelogrc\fP) will be started with all the activities listed in it. .sp If you make a mistake and type in the wrong activity name, or just forget to enter an activity, don\(aqt worry. \fBgtimelog\fP stores the time log in a simple plain text file \fB~/.gtimelog/timelog.txt\fP (or \fB~/.local/share/gtimelog/timelog.txt\fP). 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 \fBgtimelog\fP overwriting your changes — \fBgtimelog\fP 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 \fBgtimelog\fP with your editor — make sure you do not enter any activities in \fBgtimelog\fP while you have \fBtimelog.txt\fP open in a text editor. .SH OPTIONS .INDENT 0.0 .TP .B \-\-version Show program\(aqs version number and exit. .TP .B \-h\fP,\fB \-\-help Show this help message and exit. .TP .B \-\-tray Start minimized. .TP .B \-\-sample\-config Write a sample configuration file to \(aqgtimelogrc.sample\(aq. .TP .B \-\-debug Show debug information. .UNINDENT .SH FILES .nf \fB~/.gtimelog/gtimelogrc\fP \fB~/.config/gtimelog/gtimelogrc\fP .fi .sp .INDENT 0.0 .INDENT 3.5 Configuration file, see \fBgtimelogrc\fP(5). .UNINDENT .UNINDENT .nf \fB~/.gtimelog/timelog.txt\fP \fB~/.local/share/gtimelog/timelog.txt\fP .fi .sp .INDENT 0.0 .INDENT 3.5 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 \fB#\fP are comments. .UNINDENT .UNINDENT .nf \fB~/.gtimelog/tasks.txt\fP \fB~/.local/share/gtimelog/tasks.txt\fP .fi .sp .INDENT 0.0 .INDENT 3.5 Tasks to be shown in the task pane. Each line is either "task name" or "category: task name", lines starting with a \fB#\fP are comments. .UNINDENT .UNINDENT .nf \fB~/.gtimelog/remote\-tasks.txt\fP \fB~/.local/share/gtimelog/remote\-tasks.txt\fP .fi .sp .INDENT 0.0 .INDENT 3.5 Tasks to be shown in the task pane, when \fBremote_task_url\fP is set. Contains a downloaded copy of whatever is at that URL. .UNINDENT .UNINDENT .SH SEE ALSO .sp \fBgtimelogrc\fP(5) .SH AUTHOR Marius Gedminas .SH COPYRIGHT Marius Gedminas .\" Generated by docutils manpage writer. .