adding browser extension and some QoL

README.md

@@ -10,11 +10,13 @@ A modern, high-contrast **KDE Plasma System Tray Uploader** and desktop integrat
 - **Single-Instance IPC Architecture**: 100% Python-based daemon (`PySide6`). Multiple invocations (hotkeys, Dolphin context menu) delegate directly to the running tray instance without spawning duplicates.
 - **Dolphin Context Menu Integration**: Right-click any file in Dolphin -> **Actions** -> **Upload to f0ckm**.
 - **Spectacle Screenshot Capture**: Region capture integration via hotkeys or menu trigger (`f0ckm-uploader-gui --spectacle`).
+- **Browser Extension Addon (ShareX Style)**: Right-click any image, video, link, or URL on the web in Chrome, Firefox, Brave, or Edge -> **Upload with f0ckm**.
+- **Custom Protocol Scheme (`f0ckm://`)**: Seamless URL handling (`f0ckm://upload?url=...`) delegating background remote file downloading & live tray progress directly to the system tray app.
 - **Smart Notification Previews**:
   - **Images**: Fast native scaling via PySide6.
   - **Videos** (`.mp4`, `.webm`, etc.): Automatic frame extraction at `00:00:01` via `ffmpeg`.
   - **Other Files**: Sleek placeholder file badges showing the file extension.
-- **Clipboard & Settings GUI**: Direct clipboard image/path uploads and a built-in Settings dialog for configuring API keys, default tags, visibility, rating, and autostart.
+- **Clipboard & Settings GUI**: Direct clipboard image/path uploads, URL dialog uploads, and a built-in Settings dialog for configuring API keys, default tags, visibility, rating, and autostart.
 
 ---
 
@@ -104,6 +106,7 @@ To bind a keyboard shortcut to capture a screen region and upload it immediately
 - **Right Click**: Opens context menu for:
   - **Capture Region & Upload**
   - **Upload File...**
+  - **Upload URL...**
   - **Upload from Clipboard**
   - **Settings...**
   - **Quit**
@@ -119,15 +122,42 @@ To bind a keyboard shortcut to capture a screen region and upload it immediately
 # Capture screen region and upload
 f0ckm-uploader-gui --spectacle
 
-# Upload a specific file
+# Upload a specific local file
 f0ckm-uploader-gui --upload="/path/to/file.mp4"
 
+# Upload a remote image or media URL
+f0ckm-uploader-gui --upload="https://example.com/image.png"
+
+# Launch via custom protocol handler
+f0ckm-uploader-gui "f0ckm://upload?url=https://example.com/image.png"
+
 # Open settings dialog
 f0ckm-uploader-gui
 ```
 
 ---
 
+## Browser Extension (ShareX Addon)
+
+A WebExtension is provided in the `browser-extension/` directory.
+
+### Installation
+
+1. **Chrome / Brave / Edge**:
+   - Go to `chrome://extensions`, enable **Developer mode**.
+   - Click **Load unpacked** and select the `browser-extension` folder.
+2. **Firefox**:
+   - Go to `about:debugging#/runtime/this-firefox`.
+   - Click **Load Temporary Add-on...** and select `browser-extension/manifest.json`.
+
+### Features
+
+- **Context Menu**: Right-click any image, video, audio link, or URL on any webpage -> **Upload to f0ckm**.
+- **Toolbar Popup**: Click extension icon to upload active tab or paste a URL.
+- **Keyboard Shortcut**: `Alt+Shift+U` to upload current tab URL.
+
+---
+
 ## Configuration & Storage Paths
 
 - **Configuration File**: `~/.config/f0ckm-uploader/config.json`