https://github.com/smashedr/extension-manager
https://github.com/smashedr/extension-manager
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/smashedr/extension-manager
- Owner: smashedr
- License: gpl-3.0
- Created: 2024-05-05T23:53:53.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-22T10:21:16.000Z (about 2 years ago)
- Last Synced: 2024-05-22T12:05:52.725Z (about 2 years ago)
- Language: JavaScript
- Size: 589 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
[](https://addons.mozilla.org/addon/link-extractor)
[](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
[](https://addons.mozilla.org/addon/link-extractor)
[](https://github.com/smashedr/extension-manager/releases/latest)
[](https://github.com/smashedr/extension-manager/blob/master/manifest.json)
[](https://github.com/smashedr/extension-manager/actions/workflows/build.yaml)
[](https://sonarcloud.io/summary/new_code?id=smashedr_extension-manager)
# Extension Manager
Modern Chrome Web Extension and Firefox Browser Addon Extension Manager Example.
[README.md](README.md) copied from [link-extractor](https://github.com/cssnr/link-extractor) as an example.
* [Install](#install)
* [Features](#features)
* [Configuration](#configuration)
* [Development](#development)
- [Building](#building)
# Install
* [Google Chrome Web Store](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
* [Mozilla Firefox Add-ons](https://addons.mozilla.org/addon/link-extractor)
[](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
[](https://addons.mozilla.org/addon/link-extractor)
[](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
[](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
[](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
[](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
[](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp)
All **Chromium** Based Browsers can install the extension from the
[Chrome Web Store](https://chromewebstore.google.com/detail/link-extractor/ifefifghpkllfibejafbakmflidjcjfp).
# Features
Please submit a [Feature Request](https://github.com/smashedr/extension-manager/discussions/categories/feature-requests) for new features.
For any issues, bugs or concerns; please [Open an Issue](https://github.com/smashedr/extension-manager/issues).
# Configuration
You can pin the Addon by clicking the `Puzzle Piece`, find the Web Extension icon, then;
**Chrome,** click the `Pin` icon.
**Firefox,** click the `Settings Wheel` and `Pin to Toolbar`.
To open the options, click on the icon (from above) then click `Open Options`.
Here you can set flags and add as many saved regular expressions as you would like for easy use later.
Make sure to click`Save Options` when finished.
For more information on regex, see: https://regex101.com/
# Development
**Quick Start**
First, clone (or download) this repository and change into the directory.
Second, install the dependencies:
```shell
npm install
```
Finally, to run Chrome or Firefox with web-ext, run one of the following:
```shell
npm run chrome
npm run firefox
```
Additionally, to Load Unpacked/Temporary Add-on make a `manifest.json` and run from the [src](src) folder, run one of the following:
```shell
npm run manifest:chrome
npm run manifest:firefox
```
Chrome: [https://developer.chrome.com/docs/extensions/get-started/tutorial/hello-world#load-unpacked](https://developer.chrome.com/docs/extensions/get-started/tutorial/hello-world#load-unpacked)
Firefox: [https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox/](https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox/)
For more information on web-ext, [read this documentation](https://extensionworkshop.com/documentation/develop/web-ext-command-reference/).
To pass additional arguments to an `npm run` command, use `--`.
Example: `npm run chrome -- --chromium-binary=...`
## Building
Install the requirements and copy libraries into the `src/dist` directory by running `npm install`.
See [gulpfile.js](gulpfile.js) for more information on `postinstall`.
```shell
npm install
```
To load unpacked or temporary addon from the [src](src) folder, you must generate the `src/manifest.json` for the desired browser.
```shell
npm run manifest:chrome
npm run manifest:firefox
```
If you would like to create a `.zip` archive of the [src](src) directory for the desired browser.
```shell
npm run build
npm run build:chrome
npm run build:firefox
```
For more information on building, see the scripts in the [package.json](package.json) file.
## Chrome Setup
1. Build or Download a [Release](https://github.com/smashedr/extension-manager/releases).
1. Unzip the archive, place the folder where it must remain and note its location for later.
1. Open Chrome, click the `3 dots` in the top right, click `Extensions`, click `Manage Extensions`.
1. In the top right, click `Developer Mode` then on the top left click `Load unpacked`.
1. Navigate to the folder you extracted in step #3 then click `Select Folder`.
## Firefox Setup
1. Build or Download a [Release](https://github.com/smashedr/extension-manager/releases).
1. Unzip the archive, place the folder where it must remain and note its location for later.
1. Go to `about:debugging#/runtime/this-firefox` and click `Load Temporary Add-on...`
1. Navigate to the folder you extracted earlier, select `manifest.json` then click `Select File`.
1. Optional: Open `about:config` search for `extensions.webextensions.keepStorageOnUninstall` and set to `true`.
If you need to test a restart, you must pack the addon. This only works in ESR, Development, or Nightly.
You may also use an Unbranded Build: [https://wiki.mozilla.org/Add-ons/Extension_Signing#Unbranded_Builds](https://wiki.mozilla.org/Add-ons/Extension_Signing#Unbranded_Builds)
1. Run `npm run build:firefox` then use `web-ext-artifacts/{name}-firefox-{version}.zip`.
1. Open `about:config` search for `xpinstall.signatures.required` and set to `false`.
1. Open `about:addons` and drag the zip file to the page or choose Install from File from the Settings wheel.