Skip to content

Protect browsers from accessing untrusted websites. A browser extension for the paranoid.

Notifications You must be signed in to change notification settings

phishanatomy/Browser-Guard

Repository files navigation

Browser Guard Logo

Browser Guard

Protect browsers from accessing untrusted websites. A browser extension for the paranoid.

How it Works

Browser Guard intercepts all top-level navigation requests and checks if the destination is on your list of trusted domains. If it is not found, the request is blocked, and you're given the option to temporarily or permanently trust the domain.

Browser Guard block page

How to Install Browser Guard

You can install Browser Guard for Firefox by installing the Browser Guard addon from the Mozilla addon store.

Chrome (and Chromium-based browsers)

You can install Browser Guard for Chrome and Chromium-based browsers by installing the Browser Guard extension from the Chrome Web Store.

Alternatively, you can side-load Browser Guard in Chrome and Chromium-based browsers using the following steps:

  1. Download the ZIP file for the latest release of Browser Guard from releases
  2. Extract the ZIP file to a directory like C:\users\<your name>\Documents\extensions\Browser Guard
  3. Open Chrome and access your extension settings, either by navigating to Settings > Extensions, or visiting the chrome://extensions URL
  4. Enable the "Developer mode" switch
  5. Click the "Load unpacked" button
  6. Browse to the directory where you extracted the Browser Guard, e.g., C:\users\<your name>\Documents\extensions\Browser Guard (make sure you're in the same directory as the manifest.json file)
  7. Click the "Select Folder" button

Other Browsers

For all other browsers which support WebExtensions, you can build the TypeScript files yourself following the Building Browser Guard steps, and install the extension using the /src directory in your repository.

Building Browser Guard

Browser Guard uses Visual Studio Code and NPM to manage the development and build environment. Ensure you have Visual Studio Code and Node.JS installed before proceeding.

Steps to build:

  1. Clone the Browser Guard repository locally or download the repository as a ZIP file and extract it
  2. In a command prompt window, change to the "Browser-Guard" folder and run "npm install"
  3. Open the "Browser-Guard" folder in Visual Studio Code and select "Open Workspace" when prompted
  4. Open any of the files in "/src/ts"
  5. Type "Shift + Control + B"
  6. Select either "tsc: build" (to build once) or "tsc: watch" (to build after each change)

Privacy

Browser Guard takes your privacy seriously. No data is collected by Browser Guard at any point, and no connections are ever made to any remote servers.

About

Protect browsers from accessing untrusted websites. A browser extension for the paranoid.

Resources

Stars

Watchers

Forks

Packages

No packages published