pstream-docs/pages/extension.mdx
Pas 04162ed3c4
Some checks failed
docs-deploy / Build (push) Has been cancelled
Linting and Testing / Run Linters (push) Has been cancelled
docs-deploy / deploy (push) Has been cancelled
Update extension.mdx
2026-01-07 16:21:55 -07:00

134 lines
4 KiB
Text

---
title: 'Browser Extension'
---
# Browser Extension
The P-Stream browser extension enhances streaming quality and makes it possible to scrape more sources.
Check out this [explanation](https://rentry.co/htagcrv4) about what the extension does.
## [Chrome Webstore](https://chromewebstore.google.com/detail/p-stream-extension/gnheenieicoichghfmjlpofcaebbgclh)
<Warning>
## Firefox AOM
The extension is not listed on the Firefox AOM, so you'll need to install the `.xpi` manually.
Sorry, some loser keeps reporting the extension and getting it taken down. ˙◠˙
</Warning>
# Manual Installation
- [Chromium-based Installation](#chromium-based-installation)
- [Firefox-based Installation](#firefox-based-installation)
Select one of the following methods to install the extension. Ensure that you download the files compatible with your browser.
## Chromium-based Installation
These installation steps are for any chromium-based browsers such as Microsoft Edge, Google Chrome, Vivaldi, Brave, Arc or Opera.
### Loading a ZIP file
<Steps>
<Steps.Step>
Download and **unpack** the ZIP file from [here](https://github.com/p-stream/extension/releases).
</Steps.Step>
<Steps.Step>
Go to your extensions page by typing the corresponding URL into your browser
from the table below.
| Browser | URL |
|---------|-----|
| Microsoft Edge | `edge://extensions` |
| Google Chrome | `chrome://extensions` |
| Vivaldi | `vivaldi://extensions` |
| Opera | `opera://extensions` |
</Steps.Step>
<Steps.Step>Enable `Developer mode` toggle.</Steps.Step>
<Steps.Step>Click the `Load unpacked` button.</Steps.Step>
<Steps.Step>
Select the **extracted** folder from the ZIP file from **Step 1**.
</Steps.Step>
</Steps>
## Firefox-based Installation
This extension requires disabling `xpinstall.signatures.required` in `about:config` in the following supported browsers:
### Supported Browsers
- **Librewolf** (recommended)
- **Iceraven** (Android)
- **Floorp**
- **Firefox Nightly** (May have some issues)
- **Firefox Developer Edition**
- **Zen Browser**
### Installation Steps
<Steps>
<Steps.Step>
Open your supported Firefox browser and type `about:config` into the address bar.
</Steps.Step>
<Steps.Step>Click the `Accept the Risk and Continue` button.</Steps.Step>
<Steps.Step>
Search for `xpinstall.signatures.required` and set it to `false` by clicking
the toggle.
</Steps.Step>
<Steps.Step>
Download the XPI file from
[here](https://github.com/p-stream/extension/releases).
It should automatically start the installation process.
</Steps.Step>
<Steps.Step>
When prompted, choose `Continue to Installation` and then `Add`.
</Steps.Step>
</Steps>
## Workarounds for Unsupported Browsers
This extension works with unsupported browsers, but requires additional steps. Please see below.
### Regular Firefox Tutorial
#### How to use CRX Installer with regular Firefox
Complete guide for disabling signature verification in standard Firefox
In the regular version of Firefox, setting `xpinstall.signatures.required` to `false` does not work correctly. This document explains how to disable this restriction.
1. **Identify the path of omni.ja**
omni.ja is located in the Firefox installation directory.
The typical path is as follows:
```
C:/Program Files/Mozilla Firefox/omni.ja
C:/Program Files (x86)/Mozilla Firefox/omni.ja
/Applications/Firefox.app/omni.ja
/usr/lib/firefox/omni.ja
/usr/lib64/firefox/omni.ja
/opt/firefox/omni.ja
```
You can also check the location of the installation directory from the `about:support` page.
2. **Patch omni.ja**
Download [omniPatcher.py](moz-extension://4b8907c7-9352-42d6-b392-6692b947b0b7/docs/omniPatcher.py) and run it as follows:
```
python omniPatcher.py /path/to/omni.ja
```
3. **Remove startup cache**
To apply the changes, open `about:support` and delete the startup cache from the button at the top right.
This allows you to disable signature verification in the regular version of Firefox based on the value of `xpinstall.signatures.required`.