f0ckm-uploader/browser-extension

f0ckm Browser Integration Addon

A ShareX-style browser extension for Chrome, Brave, Edge, Opera, and Firefox that allows you to upload images, media, links, and URLs directly to f0ckm from any web browser context menu or toolbar popup.

---

Features

• Right-Click Context Menu (ShareX Style):
  • Upload image to f0ckm (on any image)
  • Upload media to f0ckm (on video/audio elements)
  • Upload link with f0ckm (on links)
  • Upload selected URL with f0ckm (on highlighted text URLs)
  • Upload page URL to f0ckm (on page background)
• Dual Upload Modes:
  • Desktop App Mode (f0ckm://) (Recommended): Hands off downloads and uploads to the KDE desktop system tray app. Gives you live system tray digit progress (0–99%), Spectacle notifications, audio sounds, and local history gallery.
  • Direct API Mode: Uploads directly from the browser background page using API URL and API Key without needing the tray app running.
• Toolbar Popup Interface:
  • Upload current active tab URL with one click.
  • Paste any URL for quick upload.
  • Quick toggle between Desktop App Mode and Direct API Mode.
• Global Keyboard Shortcut: Alt+Shift+U to immediately upload current page URL.

---

Installation Instructions

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 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. 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

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:

   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:

   {
     "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:

   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.
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).

---

Usage

1. Right-Click Context Menu: Right-click any image, video, audio link, or page -> select Upload to f0ckm.
2. Toolbar Popup: Click the f0ckm icon in your browser toolbar to upload the active tab or paste a URL.
3. Keyboard Shortcut: Press Alt+Shift+U on any tab.

---

Configuration

Click Settings (or right-click extension icon -> Options) to configure:

• Upload Mode: Desktop App (f0ckm://) vs Direct API.
• API Endpoint URL: Default https://your-f0ckm-instance.com/api/v2/upload.
• API Key: Secret API key for direct API mode.
• Default Rating / Tags / Visibility / OC / Copied Link Format.