Skip to content

Latest commit

 

History

History
93 lines (61 loc) · 3.53 KB

README.md

File metadata and controls

93 lines (61 loc) · 3.53 KB
Raw

AI Tab Grouper

AI Tab Grouper is a Brave extension that automatically organizes your tabs into groups using AI-powered text analysis algorithms.

CleanShot 2024-09-18 at 11 34 26@2x

Features

  • Automatically groups related tabs using advanced text analysis
  • Supports multiple grouping algorithms:
    • TF-IDF (Term Frequency-Inverse Document Frequency)
    • BM25 (Best Matching 25)
    • Keyphrase Extraction
  • Customizable settings for grouping behavior
  • Ignores pinned tabs, ensuring they remain untouched
  • Periodic automatic grouping with adjustable intervals
  • Manual grouping option
  • Persists grouping intelligence across browser sessions
  • Respects user privacy by performing all processing locally

Installation

  1. Clone this repository or download the source code
  2. Open Brave and navigate to brave://extensions/
  3. Enable "Developer mode" in the top right corner
  4. Click "Load unpacked" and select the directory containing the extension files

Usage

Once installed, the extension will automatically start grouping your non-pinned tabs based on your settings. You can access the extension's popup by clicking on its icon in the Chrome toolbar. From there, you can:

  • Manually trigger tab grouping
  • View statistics about your current tabs and groups
  • Access the settings page

Pinned Tabs

Pinned tabs are always ignored by the extension. They will not be unpinned or included in any grouping operations.

Settings

In the options page, you can customize:

  • Grouping Algorithm: Choose between TF-IDF, BM25, or Keyphrase Extraction
  • Similarity Threshold: Adjust how similar tabs need to be to be grouped together
  • Automatic Grouping Interval: Set how often the extension should attempt to group tabs
  • Maximum Group Name Length: Limit the length of automatically generated group names
  • BM25 Parameters (k1 and b): Fine-tune the BM25 algorithm if selected

To access the settings, right-click the extension icon and select "Options", or use the "Open Settings" button in the popup.

CleanShot 2024-09-18 at 11 35 11@2x

Algorithms

TF-IDF (Term Frequency-Inverse Document Frequency)

Evaluates how important a word is to a document in a collection of documents. It's effective for content-based grouping.

BM25 (Best Matching 25)

An advanced ranking function used by search engines. It can provide more nuanced grouping based on term importance and document length.

Keyphrase Extraction

Identifies the most important phrases in the tab content, which can be effective for grouping tabs with similar key topics.

Privacy

This extension does not collect or transmit any personal data. All text analysis and grouping operations are performed locally in your browser.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

GPLv3

Troubleshooting

If you encounter any issues:

  1. Check the extension's options to ensure settings are configured correctly.
  2. Try manually triggering the grouping from the popup.
  3. Disable and re-enable the extension.
  4. If problems persist, please open an issue on this repository with a detailed description of the problem and your Brave version.

Future Enhancements

  • Firefox Support
  • Support for custom grouping algorithms
  • Advanced group naming options
  • Integration with browser sync for cross-device grouping
  • Performance optimizations for handling large numbers of tabs