Skip to content

Fast tab switching and management for modern browsers (Chrome, Firefox, and Chromium-based browsers

License

Notifications You must be signed in to change notification settings

kevinma2010/smart-tab-switcher

Repository files navigation

Smart Tab Switcher

Smart Tab Switcher is a powerful browser extension that helps users efficiently manage and switch browser tabs through an intuitive interface and quick search functionality.

✨ Key Features

  • 🚀 Quick Launch: Trigger with Command+Shift+K (Mac) or Alt+T (Windows/Linux)
  • 🔍 Real-time Search: Instantly search through open tabs and bookmarks
  • ⌨️ Keyboard-Centric: Complete keyboard navigation support
  • 🎯 Smart Matching: Fuzzy search for quick target page location
  • 🔖 Bookmark Integration: Search results include bookmarks for quick access
  • 🌐 URL Recognition: Smart URL detection and direct opening
  • 🔄 Google Search: Direct Google search when no matches found

📖 User Guide

Installation

You can install Smart Tab Switcher from your browser's extension store:

Chrome Web Store Firefox Add-ons Edge Add-ons

Or install manually:

  1. Download the latest release from GitHub Releases
  2. Follow the browser-specific installation steps below:
    • Chrome/Edge:
      • Go to Extensions page
      • Enable Developer mode
      • Click "Load unpacked"
      • Select the extracted release folder
    • Firefox:
      • Go to about:debugging
      • Click "This Firefox"
      • Click "Load Temporary Add-on"
      • Select manifest.json from the extracted folder

How to Use

  1. Launch Search

    • Mac: Press Command+Shift+K
    • Windows/Linux: Press Alt+T
    • Or click the extension icon in the toolbar
  2. Search and Navigate

    • Type keywords to search tabs and bookmarks
    • Use ↑↓ keys to navigate results
    • Press Enter to open selected item
    • Press Esc to close search interface
  3. Search Result Types

    • 📑 Tabs: Switch directly to the corresponding tab
    • 🔖 Bookmarks: Open in a new tab
    • 🌐 URLs: Direct opening when URL is detected
    • 🔍 Google: Search when no matches found

💻 Developer Guide

Prerequisites

  • Node.js (v18+)
  • pnpm (v8+)
  • Browser (Chrome v88+ / Firefox v109.0+ / Edge v88+)

Local Development

  1. Clone Repository

    git clone https://github.com/kevinma2010/smart-tab-switcher.git
    cd smart-tab-switcher
  2. Install Dependencies

    pnpm install
  3. Development Mode

    pnpm dev
  4. Load in Browser

    • For Chrome/Edge:
      • Go to chrome://extensions or edge://extensions
      • Enable "Developer mode"
      • Click "Load unpacked"
      • Select the dist/chrome directory
    • For Firefox:
      • Navigate to about:debugging
      • Click "This Firefox"
      • Click "Load Temporary Add-on"
      • Select manifest.json from the dist/firefox directory

Build for Production

pnpm build

Built files will be located in the dist

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

The GPLv3 License means:

  • ✅ You can view and modify the source code
  • ✅ You can redistribute the code
  • ✅ You must keep the same license for derivative works
  • ✅ You must disclose the source code of derivative works
  • ❌ You cannot use the code in proprietary/closed source projects
  • ❌ You cannot modify the license terms

For more details, please see the full license text.

📞 Support & Feedback

🔄 Changelog

See CHANGELOG.md for version history.

About

Fast tab switching and management for modern browsers (Chrome, Firefox, and Chromium-based browsers

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published