pomodoroprompt/README.md

# 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](https://packaging.python.org/guides/installing-using-linux-tools/) 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:

```bash
#!/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`