2.5 KiB
2.5 KiB
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.
- Desktop App Mode (
- 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+Uto immediately upload current page URL.
Installation Instructions
Chrome, Brave, Edge, Opera (Chromium)
- Open your browser and navigate to
chrome://extensions(oredge://extensionsin Edge). - Enable Developer mode (toggle in the top-right corner).
- Click Load unpacked in the top-left menu.
- Select the
browser-extensionfolder in this repository (/home/kibi/Projects/f0ckm-uploader/browser-extension). - Pin the f0ckm Uploader icon to your toolbar for easy access!
Mozilla Firefox
- Open Firefox and navigate to
about:debugging#/runtime/this-firefox. - Click Load Temporary Add-on...
- Select
manifest.jsonfrom thebrowser-extensionfolder.
Usage
- Right-Click Context Menu: Right-click any image, video, audio link, or page -> select Upload to f0ckm.
- Toolbar Popup: Click the f0ckm icon in your browser toolbar to upload the active tab or paste a URL.
- Keyboard Shortcut: Press
Alt+Shift+Uon 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.