QuickSearchSwitch

Instantly switch your search query across search engines, AI assistants, images, videos, news, social media, and shopping sites.

QuickSearchSwitch is a fast, lightweight, dependency-free WebExtension for Chrome and Firefox. It automatically extracts your active search term from supported search result pages or accepts manual input, allowing you to instantly switch your query to 38 different search engines across 7 categories.

---

Features

• 🔍 Instant Query Extraction: Automatically detects active search queries from Google, Bing, DuckDuckGo, Amazon, YouTube, Reddit, and 30+ other engines.
• ⚡ 38 Engines in 7 Categories: Web, AI, Images, Videos, News, Social, and Shopping.
• ⌨️ Full Keyboard Navigation:
  • Ctrl+Shift+S / Cmd+Shift+S: Global shortcut to open popup.
  • ArrowLeft / ArrowRight: Cycle between category tabs.
  • ArrowDown / ArrowUp: Focus and navigate through engine search links.
  • Enter: Search using the category's preferred (starred) or primary engine.
  • Ctrl+Click / Cmd+Click / Middle-Click: Invert open mode (foreground vs. background tab).
  • Escape: Return focus to the search bar or close the popup.
• 🌐 Omnibox Integration: Type qs <query> into your browser address bar for instant cross-category search suggestions.
• 🖱️ Context Menu Integration: Select text on any web page → right-click → Search with QuickSearchSwitch.
• 🛠️ Options & Customization:
  • Region/TLD selection (US, UK, DE, FR, JP, CA, AU, etc.).
  • Set default category tab and default preferred engine per category (⭐).
  • Toggle engine visibility and customize display options.
  • Configure default link opening (Foreground vs. Background tab).
• 🌙 Dark & Light Mode: Automatic theme matching via CSS custom properties.
• 🔒 Privacy-First: Zero analytics, zero tracking, zero remote network calls. All favicons are bundled locally.

---

Installation

Firefox (Temporary / Manual Load)

1. Download or clone this repository.
2. Open about:debugging#/runtime/this-firefox in Firefox.
3. Click Load Temporary Add-on….
4. Select dist/firefox/manifest.json (after running bun run build.js) or manifest.firefox.json.

Chrome / Chromium (Developer Mode)

1. Open chrome://extensions/ in Chrome.
2. Enable Developer mode (toggle in upper right).
3. Click Load unpacked.
4. Select the dist/chrome/ directory (after running bun run build.js).

---

Building from Source

QuickSearchSwitch requires no npm dependencies or complex bundlers. Building uses standard Bun commands.

# Run test suite
bun test

# Build Chrome and Firefox extension targets + ZIP archives
bun run build.js

# Bump version across manifests
bun scripts/bump-version.js 1.5.0

Built files and zip packages will be generated in dist/:

• dist/chrome/ (Unpacked Chrome MV3 extension)
• dist/firefox/ (Unpacked Firefox MV3 extension)
• dist/quicksearchswitch-1.5.0-chrome.zip
• dist/quicksearchswitch-1.5.0-firefox.zip

---

Privacy Statement

QuickSearchSwitch does not collect, store, or transmit any user data. Searches are executed directly in your browser via standard tab navigation. There are no analytics, telemetry services, external tracking scripts, or third-party servers involved.

---

License

MIT License.