Installation guide

Install CleanStreak without guesswork.

Choose your browser, download the matching package, and follow the steps below. The extension runs locally and takes about two minutes to set up.

Before you start: download the correct browser package and unzip it first. When the guide asks you to select the extension, choose the folder that contains manifest.json — not the zip file itself.

Chrome, Edge, or Brave

Manifest V3 · Load unpacked

  1. Download the Chrome version and unzip it to a permanent folder.
  2. Open your browser's extensions page: chrome://extensions, edge://extensions, or brave://extensions.
  3. Turn on Developer mode using the toggle in the top-right corner.
  4. Click Load unpacked, then select the unzipped CleanStreak folder containing manifest.json.
  5. Click the puzzle-piece icon, pin CleanStreak to your toolbar, and open it to see your dashboard.
  6. For private browsing, open the extension's Details page and enable Allow in Incognito (or the equivalent setting).
Updates: keep the folder where it is. After replacing it with a newer download, return to the extensions page and click Reload on CleanStreak.

Firefox AVAILABLE

Manifest V2 · Temporary add-on installation

The Firefox build can be loaded locally today. Firefox treats locally loaded add-ons as temporary, so you may need to reload it after restarting the browser.

  1. Download and unzip the Firefox package to a permanent folder.
  2. Open about:debugging#/runtime/this-firefox in Firefox.
  3. Click This Firefox, then Load Temporary Add-on....
  4. Select manifest.json from the CleanStreak folder.
Firefox tip: For a permanent installation, use a signed Add-ons listing when available. The temporary installation is useful for trying the project locally.

If something does not work

These are the common setup issues and the quickest fixes.

“Load unpacked” is missing

Make sure Developer mode is enabled. On managed work or school browsers, an administrator may have disabled developer extensions.

The manifest cannot be found

Unzip the download and select the inner folder containing manifest.json. Do not select the downloaded archive or its parent Downloads folder.

The extension disappeared

Chrome-family browsers may disable an extension when its folder is moved or deleted. Restore the folder and use Reload. Firefox removes temporary add-ons after a restart.

Private browsing is not tracked

Open the extension's details page and enable its private/incognito permission. This is a separate browser permission from installing the extension.

Download CleanStreak Read the FAQ