gtimelog(1)

💖 gtimelog(1) — General Commands Manual 💖

okay bestie, sit down, we're learning gtimelog today and honestly? it's giving "I have my life together" energy. this is the manual page for gtimelog, section 1 of the general commands manual. let's get into it 💅

---

✨ NAME ✨

gtimelog — minimal time logging application 🎀

---

🌸 SYNOPSIS 🌸

gtimelog [options]

that's it. that's the whole vibe. she's simple. 🦋

---

💜 DESCRIPTION 💜

so gtimelog is a time tracking application that lets you, the user, track what you work on during the day and how long you spend doing it. literally your whole day, accounted for, no cap. ⏰

here's how it works, bestie: 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, iconic feature tbh). 🔥

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. your choice, main character. 👑

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, and how much time is left just to have spent a workday at the office (the number of hours in a day is configurable, so yes, you can lie to yourself, we don't judge). 🫶

there are three basic views:

• one shows all the activities in chronological order, with starting and ending times
• another groups all entries with the same title into one activity and just shows the total duration
• and a third one groups all entries from the same categories into one line with the total duration

at the end of the day you can send off a daily report by choosing Report... from the menu. you can select a date and a date range (day/week/month) and preview the report directly in the gtimelog window before sending it. 🌈

(actual sending requires a working local MTA, such as Postfix, to be installed and configured, which is outside the scope of this document. not us, not our problem, we just log time here. 🙈)

if you make a mistake and type in the wrong activity name, or just forget to enter an activity, don't worry bestie. 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. fr fr, this one bites people. 😭

---

🎀 OPTIONS 🎀

• --version — show program's version number and exit. slay, short and sweet. ✨
• -h, --help — show this help message and exit. the classic. 🦋
• --debug — show debug information. for when you wanna see the guts. 🔍
• --prefs — open the preferences window. make it yours. 💅
• --email-prefs — open the preferences window on the email page. straight to the email section, no scrolling. 👑

---

🧚 FILES 🧚

gtimelog uses XDG-compliant config and data directories by default (~/.config/gtimelog, ~/.local/share/gtimelog). for backwards compatibility, if ~/.gtimelog exists, it will be used instead. (yes, grandma config gets priority, respect your elders.)

• ~/.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/sentreports.log
• ~/.local/share/gtimelog/sentreports.log

a CSV file listing reports that have been sent. the columns are: timestamp, report kind (daily/weekly/monthly), report date, recipient's email address. 📧

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

legacy configuration file for gtimelog 0.10 and older. if it exists when gtimelog 0.11 or newer starts for the first time, settings from it will be migrated to gsettings. ⭐

---

💖 AUTHOR 💖

Marius Gedminas <mgedmin@gedmin.as> — absolute legend, we stan. 👑

---

🌸 COPYRIGHT 🌸

Marius Gedminas

---

okay that's the whole page, bestie!! 🩷

sign-off time: this was gtimelog version 0.12, dated 2019-08-05, and yes, the footer was literally just gtimelog(1) again because manpages love a symmetry moment. go log your day, main character — you got this 💜✨🦋🎀