Skip to content

Install

From the Chrome Web Store

Focus Pulse is live on the Chrome Web Store. This is the recommended way to install it — Chrome keeps it updated for you.

Install from the Chrome Web Store

  1. Open the store listing.
  2. Click Add to Chrome, then confirm the permissions prompt.
  3. Pin the Focus Pulse icon to your toolbar so today's score is one click away.

The store package is built from this repository without modification, so the code you install is the code you can read here.

Load unpacked (developers)

Focus Pulse has no build step. There is nothing to compile, bundle, or install — the repository is the extension.

  1. Clone the repository:
git clone https://github.com/Jainam249/browser-focus-tracker.git

  1. Open chrome://extensions in Chrome.

  2. Turn on Developer mode using the toggle in the top-right corner.

  3. Click Load unpacked.

  4. Select the cloned browser-focus-tracker folder.

Focus Pulse starts measuring immediately. Click the toolbar icon to view today's focus score, or open the dashboard from the popup to explore your focus history. The dashboard provides 7-day, 15-day and 30-day trend ranges, Bar Graph and Line Graph views, daily statistics, focus insights and a downloadable weekly report. Your selected graph type is remembered when you reopen the dashboard.

Permissions you will be asked for

Chrome will list the permissions at install time. Each one is used entirely on your device — the privacy policy explains what each is for.

Permission Why
tabs Read the active tab's hostname, count switches and open tabs
storage Save your statistics locally
idle Stop the clock when you step away
alarms Checkpoint the session so Chrome's suspension doesn't lose it
downloads Save exports to your Downloads folder when you ask

Incognito

Chrome does not run extensions in Incognito windows unless you explicitly allow it in chrome://extensions. Left at the default, Focus Pulse records nothing while you browse in Incognito.

Uninstalling

Remove the extension from chrome://extensions. All of its stored data is deleted with it — there is no server-side copy, because there is no server.