caarlos0/tasktimer

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

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:

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:

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:

Edit

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

tt edit

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

Badges

tasktimer's Issues

Can we have Windows binaries?

It's a very cool project, I would appreciate very much if there were windows binaries too!

The snap install does not work

In the project README there is a section for snap install

 sudo snap install tt
[sudo] password for chris: 
error: snap "tt" not found

Visual Indication of Running Timer

How do I know if a timer is currently running? It looks like the first task is always highlighted regardless of status

[Feature] Resume timer on existing task

Hi!
I was looking for a similar tool just now and this one is by far the best I could find. I love it!
However, I'd love to be able to do breaks in my tasks, and pause the timer for that duration.

I thought that perhaps the easiest way to do it is to let the user resume the timer on a given task. Under the hood, I think one more field in json file, like "break_time" (0 by default) could keep track of seconds that should be subtracted from total elapsed time of a given task.
What do you think?

Start/Stop timer bug

Hi, great little app, and seems like exactly what I need, but it currently has a strange UX quirk (possibly a bug) when starting/stopping tasks. Hitting enter on a task does not start/stop the task, it re-focuses the input for adding a new task. Also hitting enter on the input when it is empty moves the 'selected task' highlight to the top of the list.

Very strange behavior, I looked through the code and it appears intentional. The instructions in the interface directly contradict the actual behavior and I still can't find a way to 'resume' tasks.

Is this intended?