jennydaman/mindmatter

View on GitHub
README.md

Summary

Maintainability
Test Coverage
<h1><img height="40em" style="padding-right: 5px;" src="extension/assets/brain-in-pot64.png">Mind Matter</h1>

[![published version](https://img.shields.io/chrome-web-store/v/ailffedpjgpjbdadlieaccchpcdiafjc.svg)](https://chrome.google.com/webstore/detail/mind-matter/ailffedpjgpjbdadlieaccchpcdiafjc)
[![Chrome Extension](https://img.shields.io/badge/dynamic/json.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8%2BPCFET0NUWVBFIHN2ZyBQVUJMSUMgIi0vL1czQy8vRFREIFNWRyAxLjEvL0VOIiAiaHR0cDovL3d3dy53My5vcmcvR3JhcGhpY3MvU1ZHLzEuMS9EVEQvc3ZnMTEuZHRkIj48c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IiB3aWR0aD0iMjhweCIgaGVpZ2h0PSIyOHB4IiB2aWV3Qm94PSIwIDAgMjggMjgiIGVuYWJsZS1iYWNrZ3JvdW5kPSJuZXcgMCAwIDI4IDI4IiB4bWw6c3BhY2U9InByZXNlcnZlIj4gIDxpbWFnZSBpZD0iaW1hZ2UwIiB3aWR0aD0iMjgiIGhlaWdodD0iMjgiIHg9IjAiIHk9IjAiICAgIHhsaW5rOmhyZWY9ImRhdGE6aW1hZ2UvcG5nO2Jhc2U2NCxpVkJPUncwS0dnb0FBQUFOU1VoRVVnQUFBQndBQUFBY0NBWUFBQUJ5RGQrVUFBQUFCR2RCVFVFQUFMR1BDL3hoQlFBQUFDQmpTRkpOQUFCNkpnQUFnSVFBQVBvQUFBQ0E2QUFBZFRBQUFPcGdBQUE2bUFBQUYzQ2N1bEU4QUFBQUJtSkxSMFFBQUFBQUFBRDVRN3QvQUFBQUNYQklXWE1BQUE3REFBQU93d0hIYjZoa0FBQUFCM1JKVFVVSDRRd0VDd2tWNnhTb2tnQUFCSmRKUkVGVVNNZWxsbHRzRkZVWWdML3p6OHpPMGdWMnR5MkZoWXBDclhJcHJkUkdCSUpSSkNaaWlBa0pZakhHUkVQaUpRUWZqSWt4UHFqUkYzM1N4QmlpRDZCQTRnT0tDVUlmZkpDQ1FRWFNVS1ZlQ2xKYmJPa1YydEp1eSs0NVBzeE9tVzEzV2d4L01wbGt6cG4vTy8vOUtLYVIxczBid3BZazk5YUZGdS8rcmpGVXA3cEZVREZRRGF3R0tvQWtZSUFCb0JVNEN6UURWMmNDcXhsZ0thQWUyQTZzQkdJaEJ4OEd6Z0VIZ2ErQTdqQm9IakFBVThBVzRDMmdqbHNYQTV3QzNnWWFDa0VuZ0FHWUErekt3UkwvQXhhVXZ0ei9lNEJzRUNvQXl6L2FSbGVSUmNYQXVNckIzcnNOR0VBSjhBR3djN0pCQXRCeVo0emttS2FseFBYZEdMME5tQzh4NEYwTW04UlZGSzJ3UEpjbVBxOUhBUU14Ty9WeTA4QzNyL3c2V09kcVUxaUYxaUNDY2h6QWdCNzMza29JU1hnUUdpV2l0c29zMWJ0b2R4RTIzaS9NSGNuVWY3MWtkdDM5WGFNODBqV0dsb0FDWTFDUkNHNVZEWkhhQjlEelVpalIyT2syZEc4aitsb3pDbzBTUVlrZ3RvWFlEbUxiaUNQcjdiaHN6VncxZXdBUENCU0xZZnV3b3poUU9ZZXFLNk9VYUFGUllBd3lOMDdzcVdmcFhMNlJVNTB4MnJ0QUJDcm1yV0hkZzQ4eGYrUXdwbU0vSWpldzNRaVdHMEZzR3lYaTJXaW90NU1jQklhczZKT3JBTllBcndwRXVtTU84NGJHcWV3ZVFTeEJYSmZaTzU3bnpKSW4rT1M0dytrTGhvNStRM3Vmb2JuZDhGdG5sUExGSzFsWTZoRGxFcmJySW1LaFVKN3J2T2drZ0dQQVpiOUZyYzRGbVJzQ2grNk4wK2JDeU5BSXpvcFZYRjYya1gwbm9XZlFzOHpLUGFMZzd4N0QzaDl0cmtRMlExRWxJZDB1QWRSTVpDbGV1L0ppYk9CaXNjdVJleEtNWmpLWXFscE9YbzU1c0FKNVlZa0hQZDJSUU1kcXBzdmFDaDhvZUwweFR4b3E0MXhZTUFkS1U3VDFxdWtVa2RWd3FWZVJzUmNBVnRpMlpOREN2RHBRQm5wbU94eXVLbUZjUUpSaEpsRUtsREdUVlFYRitFQ04xL1h6RlJnNFVUNkxKdWt6UzB1bWgxa0NTMHMxVnFhRGtCamlNM3dMVzZjQWdXRkg4Y1Z3QzZzV0Q1RktLSFFCWFZrTmxmTVZkZVY5eVBXbTZjN1ZHZ1NleFJzeCtTZFh3c20rQzZweDhBZWVXNStsUEtuUXhvTmt0ZWVqWlNuRmpyWGp1S05IVUdQL0JGUk9zYTRKYmhaK005NDhXemQ1WjhaaytiamxLQzh0MCt6YzlCQVgvNDNUM3E4UUJVdkxOQXRMZS9tait3aExuQVpVeEdBS3Q3Z3p3TzhBZnVHbmdTTGdjU1kxUllWaVhHZjRxZWN2emcvL1NUelJUL244Zm9vU2JaeS9kb0xQemgxaXRmVUxHNG96WWJBczhEN3dNK1NhZDA3S2dHK0F0V0ZCeUJvdmlMWlk2TEVicEFmVFBGcWkrYkphRTdkRDgvTjdZTnRFMGx4OTRhQy8wSTAzcWZ2Q2dKWVNMQ1VZWXpEYVVEekxZdGRka0hSQ1laM0FPejdNcmowNkpjSU5lUFB3T2pPSU5yQ2x6UEJ3VXBNdFRMc0d2QUVjRDM0VWdJQ1Y0RjBMWGdONlEySGFzQ2dLTHk3S0VDMllsSFFDdTRGOS9nZTc5dWhONENSb0Z2Z1U3N2JXU0VnbFAxT1dvVG8yeGJwc0xtWlBBM3ZKZWRxSFFZRXhIVWdpZ0ZKZ2F3NStINURRUUhVMHcvNktFZTZJYVA4MEEzaXBmd0F2OFNZNlZ4QldFRmdBQ29ZNUtKWUROVmxEeGV1cGRQR2JDOU5hbTRtTGNCTmVuZVhGZmpJc0ZKZ0hUbWZCdFNaMmpobkY2TjdGdEgvWVRNb3AzRGNMZ1h6NUQ4WjVrNTlJaGZBQUFBQUFKWFJGV0hSa1lYUmxPbU55WldGMFpRQXlNREUzTFRFeUxUQTBWREUyT2pBNU9qSTBMVEExT2pBd1RGQTFud0FBQUNWMFJWaDBaR0YwWlRwdGIyUnBabmtBTWpBeE55MHhNaTB3TkZReE5qb3dPVG95TVMwd05Ub3dNRzgxb29RQUFBQUFTVVZPUks1Q1lJST0iIC8%2BPC9zdmc%2B&label=chrome&prefix=%E2%89%A5%20v&suffix=%20(native%20ES6)&query=minimum_chrome_version&uri=https%3A%2F%2Fraw.githubusercontent.com%2Fjennydaman%2Fmindmatter%2Fmaster%2Fextension%2Fmanifest.json)](https://developers.google.com/web/updates/2017/12/nic63)
[![license](https://img.shields.io/github/license/jennydaman/mindmatter.svg)](https://github.com/jennydaman/mindmatter/blob/master/LICENSE)
[![Build Status](https://travis-ci.org/jennydaman/mindmatter.svg?branch=master)](https://travis-ci.org/jennydaman/mindmatter)
[![codecov](https://codecov.io/gh/jennydaman/mindmatter/branch/master/graph/badge.svg)](https://codecov.io/gh/jennydaman/mindmatter)
[![Maintainability](https://api.codeclimate.com/v1/badges/82e119c8634ba4101a73/maintainability)](https://codeclimate.com/github/jennydaman/mindmatter/maintainability)

Mind Matter is an educational Chrome extension that blocks blacklisted sites, granting access only if a trivia question is answered correctly. It deters excessive use of distracting websites while helping users to reinforce their knowledge.

## Installation

Stable releases are published to the web store.

[![Available on the Chrome Web Store](/docs/webstore/available.png)](https://chrome.google.com/webstore/detail/mind-matter/ailffedpjgpjbdadlieaccchpcdiafjc)

Experimental versions are found on this repository's master branch. It can be installed as an *unpacked extension*.

[![GitHub manifest version](https://img.shields.io/badge/dynamic/json.svg?label=manifest&colorB=%23007ec6&prefix=v&suffix=&query=version_name&uri=https%3A%2F%2Fraw.githubusercontent.com%2Fjennydaman%2Fmindmatter%2Fmaster%2Fextension%2Fmanifest.json)](https://github.com/jennydaman/mindmatter/blob/master/extension/manifest.json)

1. `git clone https://github.com/jennydaman/mindmatter.git` or [Download ZIP](https://github.com/jennydaman/mindmatter/archive/master.zip) and extract it.
2. Go to [chrome://extensions](chrome://extensions).
3. Enable "Developer mode"
4. Click "Load unpacked extension..." and select the mindmatter/extension folder.
![Google Chrome extensions page](docs/screenshots/ext-page.png)

## Screenshots

![Settings page](docs/screenshots/settings.png)
![Blacklist options page](docs/screenshots/blacklist.png)
![Question prompt](docs/screenshots/question.png)
![Cooldown notification](docs/screenshots/cooldown.png)

### Rationale

The psychologist Daniel Kahneman describes two systems of thinking. According to [Wikipedia](https://en.wikipedia.org/wiki/Thinking_Fast_and_Slow), "'System 1' is fast, instinctive, and emotional; 'System 2' is slower, more deliberative, and more logical."

Surfing the Internet tends to be unproductive. The objective of *Mind Matter* is to disrupt cognitive ease and force users to perform system 2 thinking.

#### Acknowledgements

Thanks to Sally Zhao for the "brain in pot" logo.

[![Say Thanks!](https://img.shields.io/badge/-saythanks.io-ff69b4.svg?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAADAAAAAqCAMAAADCkShIAAABqlBMVEUAAADvO0LiJi3vO0LvO0LiJi3vO0LvO0LvO0LvO0LiJi3vO0LiJi3vO0LiJi3vO0LiJS3vO0LiJS3vO0LiJS3iJSzvO0LvO0LvO0LvO0LvO0LvO0LiJCzvO0LvO0LhJCzvO0LvO0LvO0LvO0LvO0LhJCvhIyvvO0LvO0LpMTjhIyvhIyvvO0LhIyvhIyrhIyrgIyrvO0LkKTDgIirvO0LgIirgIirvO0LkKDDvO0LgISnjJi7vO0LgISnvO0LvO0LiJS3gISnfISjfICjvO0LhJCvfICjfICjvO0LvO0LgIinvO0LvO0LfICffISjvO0LeHyfeHybeHibeHybvO0LeHibeHibvO0LdHSXdHSXvO0LvO0LdHSTdHSTvO0LvO0LvO0LvO0LvO0LvO0LcGyPvO0LcGyLvO0LvO0LbGSHvO0LvO0LaGB%2FaGCDvO0LvO0LZFx%2FZFh7vO0LvO0LZFh7vO0LYFR3vO0LYFBzYFR3uOkHXExvYFBzvO0LWERnWEhrXEhrXExvYFBzfICjgISngIingIirnLjboLjboLzboMDfuOkHvOkHvO0JHr331AAAAfnRSTlMAAQICAwQGBwgJDA8QExQUISIjJCUqLS8zNjc6QUJKS0tMTlBRUmJmaWtucHBzdHZ5fX6AgIGEhY6OlJSUlp2en6Cnqamqq62usLGxs7jAwsPFx8fLzc7P1NbW2Nnb3N3f4ePk5%2Bfp6%2Bzu7vH29vb3%2BPn5%2Bvv7%2FPz9%2Ff3%2B%2Fv4qZr0RAAABc0lEQVR42pXUVXfyUBCF4f25a93d3d3d3d2dqlCbUNf5z6WswCIwpw3P9Z6V9yYHui9x5V2T0%2F3N6X4wSB3cOCU6WGwKgLtvOcusO2sPgkvmBjlpw%2F%2FhEjLFbg6LPsLh%2Bwi5s2ZBF2tho7bPsPu9QkZaKRzCdthT%2FTvg%2FTx50jJg92OOvSUBjeTt6C%2BAEhas%2Fgk4IcEg8GuTJfndJLH5I5lFs0ckqkULix5INo8ZFt2QbA9nLLogBaiLZNhnyTUpaBhjwZOyaBtVLLgnlQlEsuCKVPLwYdSXoq1PQLQvRQWwqzRfNI4XX4fMFq3%2FhMO%2FOXNFB%2BHQ%2BS2YKbJGwSVw6e0iawIgX9yR5CQBBsFr7HQp7hPhIdR58Xiu3hsvLOxwK%2F3KaRBEWFRFtgxAvpCLtGwoxOxKRVohlGJ3%2BVLaq8UfexVV4FUpF%2FJeLdf4iRq8qdhmeBlNKNPIqQ6mVJOuAyY1KPZqrWTXAx90EvXCJ30DkD0DFY6c2EtNX54AAAAASUVORK5CYII%3D)](https://saythanks.io/to/jennydaman)