kibi/f0ckm-uploader
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update browser extension and app

Browse Source
This commit is contained in:
Kibi Kelburton
2026-08-13 17:21:58 +02:00
parent 7e723ae821
commit 9050faf0a4
14 changed files with 809 additions and 97 deletions
Download Patch File Download Diff File Expand all files Collapse all files

58
browser-extension/README.md
View File

@@ -25,19 +25,67 @@ A ShareX-style browser extension for **Chrome, Brave, Edge, Opera, and Firefox**
## Installation Instructions
### Chrome, Brave, Edge, Opera (Chromium)
### Chrome, Brave, Edge, Opera (Chromium) — Permanent by default
1. Open your browser and navigate to `chrome://extensions` (or `edge://extensions` in Edge).
2. Enable **Developer mode** (toggle in the top-right corner).
3. Click **Load unpacked** in the top-left menu.
2. Enable **Developer mode** (toggle switch in top-right).
3. Click **Load unpacked**.
4. Select the `browser-extension` folder in this repository (`/home/kibi/Projects/f0ckm-uploader/browser-extension`).
5. Pin the **f0ckm Uploader** icon to your toolbar for easy access!
5. *Note*: In Chromium browsers, loading unpacked extensions **remains installed permanently** across browser restarts as long as the folder location is not moved or deleted.
---
### Mozilla Firefox
1. Open Firefox and navigate to `about:debugging#/runtime/this-firefox`.
Firefox restricts unsigned extensions from being permanently installed in standard release builds by default. Choose one of the following methods for permanent installation:
#### Method 1: System Policy (`policies.json`) — Recommended for standard Firefox on Linux
1. Zip the extension directory:
```bash
cd /home/kibi/Projects/f0ckm-uploader/browser-extension
zip -r /tmp/f0ckm-uploader.xpi *
```
2. Create or edit `/etc/firefox/policies/policies.json` with superuser privileges:
```json
{
"policies": {
"ExtensionSettings": {
"f0ckm-uploader@local": {
"installation_mode": "force_installed",
"install_url": "file:///tmp/f0ckm-uploader.xpi"
}
}
}
}
```
3. Restart Firefox. The extension will be permanently installed.
#### Method 2: Firefox Developer Edition / Nightly / ESR / LibreWolf / Waterfox
1. Open `about:config` in the address bar and accept the risk.
2. Search for `xpinstall.signatures.required` and toggle it to **`false`**.
3. Package the extension as `.xpi`:
```bash
cd /home/kibi/Projects/f0ckm-uploader/browser-extension
zip -r ~/f0ckm-uploader.xpi *
```
4. Open `about:addons`, click the gear icon (⚙️) -> **Install Add-on From File...** and select `f0ckm-uploader.xpi`.
#### Method 3: Self-Signing via Mozilla Add-ons Hub (AMO) — Works on standard Firefox release
1. Zip the `browser-extension` directory contents.
2. Go to the [Mozilla Add-on Developer Hub](https://addons.mozilla.org/en-US/developers/).
3. Submit a new add-on and choose **"On your own"** (Self-distribution / unlisted).
4. Mozilla's automated scanner will sign your `.xpi` file within a minute.
5. Download your signed `.xpi` file and open it in Firefox (`Ctrl+O` or drag and drop into `about:addons`) to install permanently.
#### Method 4: Temporary Installation (Development mode)
1. Navigate to `about:debugging#/runtime/this-firefox`.
2. Click **Load Temporary Add-on...**
3. Select `manifest.json` from the `browser-extension` folder.
*(Note: Temporary add-ons automatically unload when Firefox closes).*
---