Updated README

This commit is contained in:
ManeraKai 2023-05-10 06:44:02 +03:00
parent e7beb89f53
commit 2196db43eb
No known key found for this signature in database
GPG Key ID: 5ABC31FFD562E337
2 changed files with 27 additions and 43 deletions

View File

@ -12,54 +12,37 @@ A web extension that redirects YouTube, Twitter, TikTok... requests to alternati
[![Weblate](./img/weblate.svg)](https://hosted.weblate.org/projects/libredirect/extension)
## Development
### Install Dependencies
[Node.js](https://nodejs.org/) latest LTS is recommended
```
npm update
Requirements: [Node.js LTS](https://nodejs.org/)
```bash
git clone https://github.com/libredirect/browser_extension
cd browser_extension
npm install
npm run html
npm run start # Runs on firefox using web-ext
```
Generate the HTML pages (you should install [pug-cli](https://www.npmjs.com/package/pug-cli) first globally):
```
npm run pug
```
### Build the extension zip archive:
```
npm run build
```
### Test in Firefox
```
npm run start
```
### Install temporarily
1. Type in the address bar: `about:debugging#/runtime/this-firefox`
3. Press `Load Temporary Add-on...`
### Install in Firefox ESR, Developer Edition, Nightly
1. Type in the address bar: `about:config`
2. Set `xpinstall.signatures.required` to `false`
3. Type in the address bar: `about:addons`
4. Click on the gear shaped `settings` button and select `Install Add-on From File...`
5. Select `libredirect-VERSION.zip` from `web-ext-artifacts` folder
### Install in Chromium browsers
### Run on Chromium manually
1. Open `chrome://extensions`
2. Enable `dev mode`
3. Select `load unpacked extension`
4. Select `src` folder
### Build zip package (Firefox)
```bash
npm run build
```
### Install zip package on Firefox (temporarily)
3. Type in the address bar: `about:debugging#/runtime/this-firefox`
4. Press `Load Temporary Add-on...`
5. Select `libredirect-VERSION.zip` from `web-ext-artifacts` folder
### Install zip package on Firefox ESR, Developer Edition, Nightly
3. Type in the address bar: `about:config`
4. Set `xpinstall.signatures.required` to `false`
5. Type in the address bar: `about:addons`
6. Click on the gear shaped `settings` button and select `Install Add-on From File...`
7. Select `libredirect-VERSION.zip` from `web-ext-artifacts` folder
---
Forked from [Privacy Redirect](https://github.com/SimonBrazell/privacy-redirect)

View File

@ -10,7 +10,7 @@
"start_ar": "web-ext run --firefox=/home/esmail/Downloads/ar/firefox/firefox --pref font.language.group=ar",
"build": "web-ext build",
"test": "web-ext lint",
"pug": "pug --pretty --basedir ./ --obj ./src/config.json src/pages/options/index.pug --out src/pages/options/ && pug --pretty --basedir ./ --obj ./src/config.json src/pages/popup/popup.pug --out src/pages/popup/"
"html": "pug --basedir ./ --obj ./src/config.json src/pages/options/index.pug --out src/pages/options/ && pug --basedir ./ --obj ./src/config.json src/pages/popup/popup.pug --out src/pages/popup/"
},
"repository": {
"type": "git",
@ -23,7 +23,8 @@
},
"homepage": "https://libredirect.github.io",
"devDependencies": {
"web-ext": "^7.2.0"
"web-ext": "^7.2.0",
"pug-cli": "^1.0.0-alpha6"
},
"webExt": {
"sourceDir": "./src/",