pomodoroprompt/README.md

1.9 KiB

Pomodoro Prompt

"What'd you do?" and "What're you gonna do?" dialog prompts that both pre-fill with whatever you put in for the last of either prompt at the end and start of every pomodoro work session, respectively.

Requirements

Anything other than NixOS

  • Python 3
  • pip for Python3

NOTE: Instructions are written with the assumption that the command python points to the python3 interpreter. If python --version reports a 2.x version, you should substitute python3 in the commands using python below.

NixOS

python
python311Packages.playsound
python311Packages.pycairo
python311Packages.pygobject3
python311Packages.pytz
python311Packages.tzlocal

(And skip the last two lines below, the pip install, as the above is the Nix way of doing that.)

Installation

mkdir -p ~/Projects/agaric
cd ~/Projects/agaric/
git clone git@git.agaric.com:agaric/pomodoroprompt.git
cd pomodoroprompt
python -m pip install --user -r requirements.txt

Usage

cd ~/Projects/agaric/pomodoroprompt/
python pomodoroprompt.py

See the logs/ folder for daily, one-pomodoro-at-a-time time logs.

For more convenient command prompt:

Create file ``~/.local/bin/pomodoroprompt` with contents:

#!/bin/bash

# Helper to call our pomodoro script.  We actually skip the & so we can end it
# with ctrl+c

python ~/Projects/agaric/pomodoroprompt/pomodoroprompt.py

Now you can start it with pomodoroprompt on the command line from any directory.

Desired improvements

Too many to write down. Suggest your own:

https://gitlab.com/agaric/pomodoroprompt/-/issues

Troubleshooting

If you run python pomodoroprompt.py and get:

  File "pomodoroprompt.py", line 85
    print('\r', str_minutes(to_go), sep='', end='')
                                       ^
SyntaxError: invalid syntax

You need to specify Python 3: python3 pomodoroprompt.py