GrabSHARK Browser Extension

Your gateway to your personal archive — right from your browser

The GrabSHARK browser extension brings the full power of GrabSHARK into your browser. Save pages instantly, highlight text on live websites, take smart captures, and manage your knowledge library — all without leaving the page you're on.

Available for Chromium (Chrome, Edge, Brave, Arc) and Firefox.

• One-Click Save — Save the current page to your GrabSHARK library with a single click
• Embedded In-Page UI — Click the extension icon to open the GrabSHARK panel directly within any webpage — no popup needed
• Duplicate Detection — Automatically checks if a link already exists before saving
• Collection & Tag Picker — Assign collections and tags right from the save panel
• Bulk Save — Save all tabs in the current window at once

• Persistent Highlights — Select text on any live website and highlight it with colors — highlights sync to your GrabSHARK library and reappear when you revisit the page
• Notes on Live Sites — Attach notes to any highlight directly on the page via the Note Panel
• Highlight Toolbox — A contextual toolbar appears on text selection for quick highlight/note actions

• Element Detection — Intelligently detects page elements (articles, images, sections) for precise capture
• Marquee Selection — Draw a selection box to capture any specific area of a page
• Capture Action Bar — Contextual toolbar with capture options after selection

• Right-click on any page, link, image, or text selection to save directly to GrabSHARK
• Quick access to common actions without opening the extension panel

• Real-time badge count on the extension icon
• Visual indicator when the current page is already saved in your library

• Auth — Sign in with API key or Username/Password
• Archive Format Sync — Your archive format preferences (Screenshot, PDF, Readable, Monolith) sync from your GrabSHARK account
• Custom Shortcuts — Fully configurable keyboard shortcut (default: Cmd+Shift+Y on Mac, Ctrl+Shift+F on Windows/Linux)
• Preferences Sync — Extension theme and language matches your GrabSHARK preference
• Bookmark Integration — Works with your browser's native bookmarks

15 languages supported:

English, Türkçe, Deutsch, Español, Français, Italiano, 日本語, Nederlands, Polski, Português (BR), Română, Русский, Українська, 中文, 中文 (繁體)

• Chrome / Edge / Brave: Chrome Web Store
• Firefox: Firefox Add-ons

• Node.js 18+ (LTS)
• npm 9+
• Git

# 1. Clone
git clone https://github.com/grabshark/grabshark-extension.git
cd grabshark-extension

# 2. Install dependencies
npm install

# 3. Build
chmod +x ./build.sh && ./build.sh

The built extension will be in the /dist folder. Load it as an unpacked extension in your browser:

• Chrome: chrome://extensions → Enable "Developer mode" → "Load unpacked" → Select /dist/chromium
• Firefox: about:debugging → "This Firefox" → "Load Temporary Add-on" → Select any file in /dist/firefox

src/
├── @/                    # Shared modules
│   ├── components/       # Reusable UI components (SaveLink, EditLink, Preferences, etc.)
│   ├── hooks/            # Custom React hooks
│   ├── lib/              # Utilities, config, actions, cache
│   └── locales/          # 15 language files
├── pages/
│   ├── Background/       # Service worker & managers
│   │   └── managers/     # Auth, Badge, Bookmarks, Context, Links, Media, Message routing
│   ├── ContentScript/    # Content scripts injected into web pages
│   │   ├── SmartCapture/ # Element detection, marquee selection, capture UI
│   │   ├── HighlightToolbox/  # Live highlight creation
│   │   ├── NotePanel/    # Inline note editing
│   │   └── EmbeddedApp/  # In-page GrabSHARK panel
│   ├── Popup/            # Extension popup (if icon clicked)
│   └── Options/          # Extension settings page

If you find GrabSHARK useful, consider supporting its development:

This extension is part of the GrabSHARK project, licensed under the MIT License.