pomodoroprompt/README.md
Chris (wolcen) Thompson 49295ab573 Make nix do things
2024-11-13 20:52:15 -05:00

2.2 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

nix-shell
python pomodoroprompt.py

...or:
alias pom="nix-shell --command 'python pomodoroprompt.py'

You need not install Python (and it is not recommended). Should you insist, this may be correct:

python
python311Packages.playsound
python311Packages.pycairo
python311Packages.pygobject3
python311Packages.pytz
python311Packages.tzlocal
wrapGAppsHook
gobject-introspection

(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