jupyterlab-pomodoro 0.1.0

A JupyterLab extension for Pomodoro timer

jupyterlab-pomodoro

A JupyterLab extension for Pomodoro timer productivity tracking.

Features

• 🍅 Pomodoro timer in the JupyterLab status bar
• ▶️ Start / ⏸ Pause the timer with one click
• ↺ Reset the current session
• Automatic work → short break → long break cycling
• 🔔 Desktop notifications when a phase ends
• ⚙️ Configurable durations via JupyterLab Settings Editor

Requirements

• JupyterLab >= 4.0.0

Install

pip install jupyterlab_pomodoro

Development Install

# Clone the repo and activate a venv with JupyterLab installed
git clone https://github.com/MakinetaJim/jupyterlab-pomodoro
cd jupyterlab-pomodoro

# Install JS deps and build
jlpm install
jlpm build

# Install extension in dev mode
pip install -e ".[test]"
jupyter labextension develop . --overwrite

# Watch for changes
jlpm watch

Settings

Open Settings → Settings Editor → Pomodoro Timer to configure:

Setting	Default	Description
Work Duration	25 min	Length of a work session
Short Break	5 min	Short break after each pomodoro
Long Break	15 min	Long break after N pomodoros
Long Break Interval	4	Pomodoros before a long break

License

BSD 3-Clause