Skip to content

caarlos0/tasktimer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

header image

tasktimer

Task Timer (tt) is a dead simple TUI task timer.


Usage

To get started, just run tt:

tt

You'll be presented with something like this:

image

You can just type a small description of what you're working on and press ENTER to start timing.

At any time, press ENTER again to stop the current timer or type a new task description and press ENTER to stop the previous task and start the new one.

Each task will have its own timer, and the sum of all tasks will be displayed in the header:

image

At any time, press CTRL+c to stop the current timer (if any) and exit.

You can also press ESC stop the current task and blur the input field and navigate around a long list of tasks using the arrow keys/page up/page down/etc.

Note: there is no concept of "resuming tasks", you can however create several tasks with the same description.

Report

You can extract a markdown file by running:

tt report

It will output the given project (via -p PROJECT) to STDOUT. You can then save it to a file, pipe to another software or do whatever you like:

image

Edit

Let's say you forgot the timer running... you can edit it using the edit command:

tt edit

image

The project will be exporter to a JSON file and will open with your $EDITOR. Once you close it, it will be imported over the old one.

You can also backup/edit/restore using tt to-json and tt from-json.

Help

At any time, check --help to see the available options.

Install

homebrew:

brew install caarlos0/tap/tt

apt:

echo 'deb [trusted=yes] https://repo.caarlos0.dev/apt/ /' | sudo tee /etc/apt/sources.list.d/caarlos0.list
sudo apt update
sudo apt install tt

yum:

echo '[caarlos0]
name=caarlos0
baseurl=https://repo.caarlos0.dev/yum/
enabled=1
gpgcheck=0' | sudo tee /etc/yum.repos.d/caarlos0.repo
sudo yum install tt

arch linux:

yay -S tasktimer-bin

deb/rpm/apk:

Download the .apk, .deb or .rpm from the releases page and install with the appropriate commands.

manually:

Download the pre-compiled binaries from the releases page or clone the repo build from source.

FAQ

Where are data and logs stored?

Depends on the OS, but you can see yours running:

tt paths

Stargazers over time

Stargazers over time

Badges

Release

Software License

Build

Go Report Card

Powered By: GoReleaser