waynew / pymato

Simple command line pomodoro timer

pymato

The Simple Python Tomato (Pomodoro) timer.

Usage

$ python -m pip install --user pymato
$ pymato pom doing something cool
Task - doing something cool
0:24:59

When the timer runs out it will emit a visual bell, so your terminal should blink or notify you of activity. Want to see what you've been working on?

$ pymato log
2018-02-28
            25m writing pymato documentation
            25m doing something cool
-----------------------------------------
            50m total pomodoro time

Right now that's pretty much all it does. It saves your logs to pymato.log in the current folder. You can delete or edit entries that way. If you start a task and you get called away in the middle of your pom, you can just hit ctrl+c. Then it will ask if you'd like to save that pom.

$ pymato pom a task that will get interrupted
Task - a task that will get interrupted
^C0:23:59Aborted - save to log anyway?
y/[n]: y
$ pymato log
2018-02-28
            25m writing pymato documentation
            25m doing something cool
             7m doing something cool
-----------------------------------------
            57m total pomodoro time

Would you like to play a sound on completion of your pom? Fortunately your shell has already provided that functionality! For most shells, this should work correctly:

$ pymato pom "play a sound"; ogg123 chime.ogg; notify-send "Done!"

That should work for most, if not all common shells (bash, fish, zsh).

Future Goals

I'd like to have pymato sum that would give you a summary - probably with the option to group by either task or day. Might be nice to see some kinds of ascii graphs or something too. I'd also be down with the ability to add notes to entries if you need to keep a record of things you've done. Or the ability to link work to your git/hg/svn commit history.

pymato's Issues

Configure Pymato to use User sounds.

Would it be possible to tell pymato what sounds to use?

pymato pom doing something -s /path to secs.mp3   -r /path to complete.mp3

• -s = tell the program to use a file as the seconds' timer or countdown timer. It really brings the focus in.

• -r =when a pom is resolved or completed, play this sound.

With my current config, I get a 2secs vibration when a pom is completed, which is very easy to miss.

Make Task Time in Pymato Log Human Readable

After running a pymato track session, the log outputs:

2019-08-31 08:21:32+0000 2019-08-31 09:15:45+0000 Updating Trello

I have to subtract time from both markers to get an idea of how much time is spent.

is it possible for the log to record this?

2019-08-31 08:21:32+0000 2019-08-31 09:15:45+0000 - total time spent 0:54:11 - Updating Trello