ttimelog

README

ttimelog

Warning This project is a Work in Progress (WIP). Features and UX may change.

A terminal-based time tracking application written in Go. Inspired Collabora's gtimelog fork, built with Bubble Tea.

Motivation

gtimelog is a GNOME-based time tracking app written in Python. Collabora maintains a fork with Chronophage integration.

ttimelog is a Go-based terminal rewrite aiming to provide the same functionality:

• Terminal-native UI
• Just for fun!

Installation

go install github.com/Rash419/ttimelog/cmd/ttimelog@latest

Usage

Keybindings

General

Key	Action
Tab / Shift+Tab	Cycle focus between panes
Ctrl+P	Open project tree
Alt+S	Submit timesheet to Chronophage
Ctrl+C	Quit

Input Pane

Key	Action
Enter	Submit task
Esc	Cancel editing

Table Pane

Key	Action
e	Edit selected entry
d	Delete selected entry
p	Reassign project for selected entry

Project Tree

Key	Action
j / k or ↑ / ↓	Navigate
Space	Expand/collapse node
/	Search projects
Enter	Select project
Esc	Close overlay

Task Markers

• **arrived: Mark work start time
• **task description: Mark as slack/break time

Status Bar

A bottom status bar (lazygit-style) shows context-sensitive keyboard shortcuts on the left and transient status messages on the right, color-coded by type (yellow = in progress, green = success, red = error).

Data Location

• ~/.ttimelog/ttimelog.txt: Timelog entries
• ~/.ttimelog/ttimelogrc: Configuration file (INI format)
• ~/.ttimelog/ttimelog.log: Application logs

Todo

Core Features

• Configurable target hours (daily/weekly)
• Edit/delete existing entries
• Keyboard navigation in table
• Project tree with search and recent projects
• Bottom status bar with shortcut hints
• Reports/export functionality
• Theme support

Chronophage Integration

• Submit timesheet via Alt+S
• Submit weekly status reports with email

License

This project is licensed under the MIT License - see the LICENSE file for details.