Skip to main content

Get work done when you need to, goof off when you don't.

Project description


PyPI version Test Status Lint Status codecov Join the chat at License Downloads Code style: black Imports: isort

Read Latest Documentation - Browse GitHub Code Repository

Stay focused on work when you want, and goof off when you don't. Concentration is a simple Python 3 console utility to block distracting sites when you need to focus, while allowing you to easily take timed breaks. Concentration uses the /etc/hosts file as the mechanism to block sites, and works on Linux, Macintosh, and Windows.

Concentration Example

Installing Concentration

pip3 install concentration

Or, if pip is already set to use Python 3

pip install concentration

Or, if you wanted concentration installed and ran in an isolated environment, consider using pipx:

pipx run concentration

Using Concentration

To keep focused (blocking distracting sites):

sudo concentration improve

To take a small 5 minute timed break:

sudo concentration break

To take a long 60 minute timed break:

sudo concentration break -m 60

You can cancel breaks with Ctrl-C.

To disable blocking until you explicitly enable it again:

sudo concentration lose

Configuring Concentration

You can add more files to the blocked list by putting them in the following files (new line delimited):

  • ~/.concentration.distractors
  • /etc/concentration.distractors

You can make sure sites are visible even if concentration is enabled by putting them in the following files (new line delimited):

  • ~/
  • /etc/

Thanks and I hope you find concentration useful in your effort to get more done!

~Timothy Crosley

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

concentration-1.1.5.tar.gz (6.1 kB view hashes)

Uploaded source

Built Distribution

concentration-1.1.5-py3-none-any.whl (6.7 kB view hashes)

Uploaded py3

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