Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

Privy

1. Privy

Firefox Add-on License: MPL 2.0

Privy is a browser extension that can open URL in private tab and search selected text in private tab.

Available on Firefox Add-ons. Chromium builds are not published to the Chrome Web Store — build from source and load the extension unpacked (see section 2.2).

1.1. Open in Private Tab

Open the current tab URL in a private tab. Click the Privy Button on the top right corner of the browser.

Open In Private Tab
Open Current Tab URL in a Private Tab

1.2. Search in Private Tab

Search the selected text in a private tab. Select some text in a webpage and choose Search Privately from the context menu.

Search In Private Tab
Search Selected Text in a Private Tab

1.3. Permissions

Privy requests the minimum it needs to work.

Permission Type Why it is needed
Access browser tabs Required Read the current tab URL and open a new private tab
Access your data for all websites Optional Read the text you select in a page for Search Privately

The optional permission is only requested when you use the context menu feature. Privy collects no data, sends nothing to any server, and has no analytics.

2. Installation

2.1. Firefox

Install directly from the official listing:

https://addons.mozilla.org/en-US/firefox/addon/privy/

2.2. Chromium (Chrome, Edge, Brave, Opera)

There is no Chrome Web Store release. Build from source, then load the unpacked extension:

  1. Follow the build steps in section 3 using the chromium target.
  2. Open your browser and go to chrome://extensions (or edge://extensions, brave://extensions).
  3. Enable Developer mode.
  4. Click Load unpacked.
  5. Select the generated folder, for example dist/privy.chromium.v.1.0.1/.

The extension stays installed until you remove it, but Chromium may prompt you about developer-mode extensions on each browser restart.

3. Building from Source

Privy builds both browser targets from a single source tree. Each target has its own manifest (manifest.firefox.json, manifest.chromium.json), and a custom Node.js script assembles a versioned bundle for the target you choose.

3.1. Clone the Repository

git clone https://github.com/theashiq/Privy.git

3.2. Navigate to the Project Directory

cd Privy

3.3. Ensure Node.js is Installed

The build uses a custom Node.js script. Verify your installation:

node -v

If Node.js is not installed, download it from the official Node.js website.

3.4. Run the Build Script

The build script takes two arguments:

Argument Values Description
browser firefox or chromium Target browser
version e.g. 1.0.1 Version number for the build
npm run build:<browser> <version>

For example, to build for Firefox version 1.0.1:

npm run build:firefox 1.0.1

Or for Chromium-based browsers:

npm run build:chromium 1.0.1

The script will:

  • Clean or create a version-specific folder inside dist/
  • Copy the necessary files from src/ into that folder
  • Copy the correct manifest for the selected browser

On success you will see:

✅ Build complete for firefox version 1.0.1. Files are in dist/privy.firefox.v.1.0.1/

3.5. Check the Output

The built files land in dist/, in a folder named for the browser and version — for example dist/privy.firefox.v.1.0.1/ or dist/privy.chromium.v.1.0.1/.

3.6. Deploy or Use the Built Files

Load the folder as an unpacked extension (see section 2.2), or package it for submission to the relevant add-on store.

4. Project Structure

Privy/
├── src/ shared extension source
├── screenshot/ README screenshots
├── manifest.chromium.json Chromium manifest
├── manifest.firefox.json Firefox manifest
├── build.js custom build script
└── package.json

5. License

Licensed under the Mozilla Public License 2.0.

About

Privy is a browser extension that can search selected text and open urls in private tab

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /