Skip to content

zaunere/tab-keyword-grouper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 

Repository files navigation

Smart Tab Grouper v2.1 - Dynamic Edition

Automatically discover and group your browser tabs based on common keywords!

✨ What's New in v2.1

  • 🎯 Keyword Priority - Your keywords get highest priority
  • 🌐 Domain Matching - Matches domain names (github.com → "github")
  • ➕ AND Operator - github+tauri groups tabs with BOTH words
  • ➖ NOT Operator - github-wordpress groups GitHub but excludes WordPress
  • 🚫 Better Stopwords - Filters out "search", "google", "results" etc.
  • 👁️ Auto Preview - Live preview updates as you type
  • ⭐ Priority Indicator - Stars show your keyword groups

🚀 Quick Start

  1. Load the extension (chrome://extensions → Load unpacked → select dist)
  2. Enter keywords (optional): code, shop, learn
  3. See live preview as you type
  4. Click "Group All Tabs"

💡 Keyword Examples

Simple Keywords

code, shop, learn

Groups tabs by these broad categories.

AND Operator (+)

github+tauri

Only groups tabs that contain BOTH "github" AND "tauri".

NOT Operator (-)

github-wordpress

Groups tabs with "github" but EXCLUDES any with "wordpress".

Combined

code, github+rust, amazon-reviews, learn
  • code - All coding-related tabs
  • github+rust - GitHub tabs specifically about Rust
  • amazon-reviews - Amazon tabs but not review pages
  • learn - Tutorial and learning content

🎯 How It Works

1. Extraction

  • Tokenizes all tab titles
  • Extracts domain names (github.com → "github")
  • Removes stopwords (search, google, com, etc.)

2. Analysis

  • Counts keyword frequencies
  • Finds most common keywords
  • Identifies patterns

3. Prioritization

Your keywords = Highest priority

  • User keywords matched first
  • Domain names matched second
  • Common keywords matched last

4. Grouping

  • Creates groups based on matches
  • Assigns colors
  • Leaves unmatched tabs ungrouped

🔧 Advanced Usage

For 120+ Tabs

Recommended settings:

  • Minimum Group Size: 2-3
  • Maximum Groups: 10-12
  • Frequency Threshold: 2

Recommended keywords:

code, docs, shop, learn, news

For Developers

github, docs, stackoverflow, npm+package

For Researchers

scholar, paper, research, wikipedia-talk

For Shoppers

amazon, ebay, shop-reviews

⚙️ Settings

  • Minimum Group Size - Don't create tiny groups (default: 3)
  • Maximum Groups - Limit total groups (default: 8)
  • Frequency Threshold - How common keywords must be (default: 2)
  • Stop Words - Words to ignore (includes search engines)
  • Colors - Group colors

🌟 Priority System

Groups are created in this order:

  1. ⭐ Your keywords (highest priority)
  2. Domain matches (e.g., github.com)
  3. Common keywords (auto-discovered)

Your keywords always win conflicts!

📊 Performance

  • Speed: ~35ms for 120 tabs
  • Memory: ~10-20MB
  • No dependencies: Pure JavaScript
  • Offline: Works completely offline

🔒 Privacy

  • ✅ All processing happens locally
  • ✅ No data sent anywhere
  • ✅ No tracking
  • ✅ Open source

💡 Tips

  1. Start simple - Try 3-5 basic keywords first
  2. Use operators - Add +/- for precision
  3. Watch the preview - It updates as you type
  4. Look for stars - ⭐ shows your keyword groups
  5. Adjust settings - Fine-tune thresholds for your tab count

🐛 Troubleshooting

Search results dominating groups?

Already fixed! "search", "google", "results" are now stopwords.

Want more specific groups?

Use operators: github+tauri instead of just github

Too many/few groups?

Adjust "Minimum Group Size" and "Maximum Groups" in settings.

📝 Changelog

v2.1.0

  • Added +/- operators
  • User keywords now highest priority
  • Domain matching
  • Better stopwords (search engines)
  • Auto-preview (removed preview button)
  • Priority indicators (stars)
  • Improved examples and hints

v2.0.0

  • Initial dynamic grouping release

Perfect for power users with 120+ tabs! 🎉

About

Intelligently group tabs according to custom keywords.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors