py-pomo 1.0

A simple CLI pomodoro timer

py-pomo

A simple CLI pomodoro timer, made with Python w/Click.

All contibutions are welcome.

---

• py-pomo
  • Usage
  • Examples
  • Todo

Usage

git clone https://github.com/BasicPixel/py-pomo.git # Clone this repo
cd py-pomo

virtualenv venv # Start a virtualenv (on unix systems, requires virtualenv package)
. venv/bin/activate

pip install --editable . # Install the package

pomo --help # Run the script

Examples

Start a 25-minute pomo timer:

pomo

Start a timer for 30 seconds:

pomo -s -d 30

# Or
pomo --in-seconds --duration 30

Start a 10-minute timer, with minimal output (MM:SS):

pomo -m -d 10

# Or
pomo --minimal --duration 10

---

Learn more about the available options by running:

pomo --help

Todo

• Save configuration to a file
• Publish to PyPI
• Test on different environments