Skip to main content

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

Supported platforms:

  • Linux

  • macOS

Requirements:

Pick a client from the table below and run:

$ pip install just-start[<client_name>]

If you pick urwid, you should run:

$ pip install just-start[urwid]

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

Usage

$ just-start-<client_name>

So for the urwid client:

$ just-start-urwid

Press h to see a list of available user actions.

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.

Issues are tracked using GitHub Issues

Running Tests

First, you’ll need the Development dependencies. Then, just issue the following:

$ coverage run --source=just_start,just_start_urwid -m pytest; coverage report

Release files for just-start 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for just-start 0.5.0
File Size Uploaded
just-start-0.5.0.tar.gz 24.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for just-start 0.5.0
File Interpreter ABI Platform
just_start-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 49.8 kB

Release files / just-start-0.5.0.tar.gz

Download URL just-start-0.5.0.tar.gz
Size 24.0 kB
Tags Source
SHA-256 checksum
How to use checksums
78eb0cc09a37490f87dd49ff5ba5062ee2560b988c87b0947d76c815e0f6e70c
BLAKE2b-256 checksum
How to use checksums
bc3f432379f36c905f407428725458e7ed3553e357070eb1af457e13d60c84f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/0.12.17 CPython/3.7.3 Darwin/18.7.0

Release files / just_start-0.5.0-py3-none-any.whl

Download URL just_start-0.5.0-py3-none-any.whl
Size 25.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
58667df9b03c70f4de315dda70659a1bc16601c1a36347fc9a8b05373258669e
BLAKE2b-256 checksum
How to use checksums
c4b61a2c8cd3c7b7597426e6f3fbd9bd9698d2137f0c06f245c02dfb00be600f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/0.12.17 CPython/3.7.3 Darwin/18.7.0

Release history Release notifications | RSS feed

0.5.2

2 release files

0.5.1

2 release files

This release

0.5.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page