Skip to content

Pomodoro todo list app with an integrated website blocker and timeboxing

License

Notifications You must be signed in to change notification settings

kun-codes/pomodoro-task-app.py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pomodoro-task-app.py

Pomodoro todo list app with an integrated website blocker and timeboxing

Important

pomodoro-task-app.py assumes that you aren't using a proxy server already since it runs a local proxy server to block websites.

Features

  • Cross Platform: pomodoro-task-app.py is cross-platform and can be used on Windows, macOS and Linux.
  • Website Blocker: Websites can be blocked using either a blocklist or an allowlist.
  • Timeboxing: pomodoro-task-app.py has integrated timeboxing features.

Installation

Currently, there is no installer provided. You can run the app by doing the following:

  • Install Python 3.12 if you haven't already.
  • Install Poetry
  • Clone the repository using the command
git clone https://github.com/kun-codes/pomodoro-task-app.py.git
  • Change the directory to the repository
cd pomodoro-task-app.py
  • Install the dependencies using poetry
poetry install
  • Run the app using the command
poetry run python pomodoro-task-app

Usage

Important

On your first run of the application, start the timer and then go to mitm.it on a chromium based browser and install the certificate as per your OS and browser choice. This is required for the website blocker to work. After installing the certificate, restart the application.

  • Start the app using the command mentioned above.

There are four main screens in the app:

  1. Task View: This is where you can add, delete and view tasks.

image

  1. Timer View: This is where you can start the timer and view the time left.

image

  1. Website Filter View: This is where you can add, delete and view websites to block and choose between a blocklist and a whitelist. Please enter the website without the protocol (http/https) as shown in the image.

image

  1. Workspace Selector View: This is where you can select the workspace you want to work in. Each workspace has its own adjustable timer and website filter settings. Each workspace also has its own tasks.

image

Known Bugs

  • The website blocker doesn't work as expected when there are no websites in the currently selected list (blocklist or allowlist).

Credits

  • Super Productivity: The app is inspired by Super Productivity.
  • chomper: The website blocker has some functionality inspired by chomper.

About

Pomodoro todo list app with an integrated website blocker and timeboxing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages