Skip to main content

Just Start is a wrapper for Task Warrior with pomodoro support

Project description

Build Status Coverage Status

An app to defeat procrastination!

Introduction

Just-Start is a to-do list application and productivity booster. It prevents you from procrastinating (too much).

The program is a wrapper for TaskWarrior with a timer implementing the Pomodoro Technique (time management). It also draws a bit of inspiration from Omodoro.

Features:

  • Configurable pomodoro phase durations

  • Support for multiple configurations (a.k.a. locations) based on the current time and day of the week

  • Desktop notifications

  • Block time-wasting sites while you’re working

Installation and usage

Supported platforms:

  • Linux

  • macOS

Requirements:

Pick a client name from the table below and run:

$ pip install just-start[<client_name>]
$ just-start-<client_name>

So for the urwid client:

$ pip install just-start-urwid
$ just-start-urwid

Press h to see a list of available user actions.

Clients

Name

Framework

Notes

urwid (recommended)

Urwid

Inspired by Calcurse. Similar to a graphical application, but in your terminal

term

Terminal (none)

Example client. Useful for seeing how to write a brand new one but not intended for continuous usage

Development

If you want to help out please install Poetry, clone the repo and run:

$ cd just-start/
$ poetry install

This will ensure you have both the development and install dependencies.

You can also install the package in editable mode to test manually without having to run a build after every change, but you’ll need to generate a setup.py since projects using pyproject.toml alone can’t be used this way (see the note about editable mode in PEP517 for more info). I use Dephell for this:

$ cd just-start
$ dephell deps convert --from=pyproject.toml --to=setup.py
$ pip install -e just_start

Bug reports

Issues are tracked using GitHub Issues

Running Tests

You just need Poetry and Tox

$ tox

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

just-start-0.5.2.tar.gz (24.9 kB view details)

Uploaded Source

Built Distribution

just_start-0.5.2-py3-none-any.whl (26.6 kB view details)

Uploaded Python 3

File details

Details for the file just-start-0.5.2.tar.gz.

File metadata

  • Download URL: just-start-0.5.2.tar.gz
  • Upload date:
  • Size: 24.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.10.1 Linux/5.15.12-arch1-1

File hashes

Hashes for just-start-0.5.2.tar.gz
Algorithm Hash digest
SHA256 34f0fa99196631db68ddc8c52c4a5d1ed623a573eb01191eba620c89ba16b9d0
MD5 6b7a8c076f9470c336d3edc1cc61162e
BLAKE2b-256 0664fc5ea0ea3f8deb862f2fddc5e8535d25169f3c5fb5bba3bd70fac5c0130c

See more details on using hashes here.

File details

Details for the file just_start-0.5.2-py3-none-any.whl.

File metadata

  • Download URL: just_start-0.5.2-py3-none-any.whl
  • Upload date:
  • Size: 26.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.10.1 Linux/5.15.12-arch1-1

File hashes

Hashes for just_start-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 454bbc5f1bb29957b0d39cae48445fb582751f2ef63847ed4180d55e6e3b72c5
MD5 211d22cf3485951137b2cfbf9df1a20b
BLAKE2b-256 e4a3051c4adf5669fe834f195c8d15eed80219bfb47c0fc9b86e6b26fd58deaa

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page