A privacy-first Chrome Extension that filters specific topics (default: "Orange") from your browsing feed using Network blocking, DOM text analysis, and local AI image processing.
- Download: Get the
the-orange-filter-v1.zipfile from this repository. - Unpack: Unzip the file to a folder on your computer.
- Open Chrome: Navigate to
chrome://extensionsin your browser. - Developer Mode: Enable Developer mode using the toggle in the top right corner.
- Load Extension: Click the Load unpacked button.
- Select Folder: Choose the folder where you unzipped the files (it should contain
manifest.json).
If you want to build the extension yourself:
-
Build the Project:
npm install npm run build
-
Load into Chrome:
- Open
chrome://extensions. - Click Load unpacked.
- Select the
distfolder inside this project directory.
- Open
-
Basic Filtering:
- Go to a website containing the keyword "Orange" (e.g., a news site or Wikipedia).
- Observe that articles or paragraphs containing the keyword are hidden.
- Click the extension icon in the toolbar to see the blocked item count.
-
AI Image Filtering (Premium/Experimental):
- Click the extension icon to open the Popup.
- Toggle "AI Image Filtering" ON.
- Accept the Privacy Consent dialog.
- Reload the page. Images matching the "Orange" face vectors should now be scanned and hidden.
Run the included unit and integration tests:
npm test- Watch Mode:
npm run watch(Rebuilds on file changes). - Linting:
npm run lint(Checks code style).