Skip to content

๐Ÿ—‚๏ธ Because 147 tabs is too many. Track, analyze, and actually manage your browser tabs with stats, insights, and smart cleanup recommendations.

License

Notifications You must be signed in to change notification settings

aki21j/browser-tab-stats

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

33 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Tab Stats - Smart Tab Manager ๐Ÿ—‚๏ธ

Because 147 tabs is too many. Track, analyze, and actually manage your browser tabs with stats, insights, and smart cleanup recommendations.

A Chrome/Brave extension that helps you understand and control your tab chaos with detailed statistics, usage insights, and intelligent recommendations.

Version License

โœจ Features

๐Ÿ“Š Comprehensive Statistics

  • Tab counts - Total tabs and per-window breakdown
  • Age tracking - How long each tab has been open
  • Usage frequency - Times each tab has been accessed
  • Last access time - When you last viewed each tab
  • Domain analysis - Tabs grouped by website

๐ŸŽฏ Smart Recommendations

  • Inactive tabs - Not accessed in 7+ days (configurable)
  • Duplicate detection - Same URL open multiple times
  • Rarely used - Old tabs with minimal interaction
  • Priority levels - High/medium/low urgency

๐Ÿš€ Two Interfaces

Side Panel (Chrome) / Dashboard (Brave)

  • Quick access stats
  • Sortable tab lists
  • One-click tab management
  • Real-time updates

Full Dashboard (Both browsers)

  • Beautiful charts and visualizations
  • Advanced search and filtering
  • Bulk actions (close inactive, remove duplicates)
  • Domain-based analysis
  • Customizable settings

๐Ÿ’ก Smart Actions

  • Close all inactive tabs at once
  • Remove duplicate tabs automatically
  • Select and close specific tabs
  • Export statistics as JSON

๐Ÿš€ Quick Start

Installation

  1. Clone this repository:
git clone https://github.com/yourusername/browser-tab-stats.git
  1. Open Chrome/Brave and navigate to:

    • Chrome: chrome://extensions/
    • Brave: brave://extensions/
  2. Enable Developer mode (toggle in top-right)

  3. Click Load unpacked

  4. Select the browser-tab-stats folder

  5. Done! Click the Tab Stats icon to start

First Use

Chrome: Click the icon โ†’ Side panel opens
Brave: Click the icon โ†’ Dashboard opens in new tab

Browse your tabs, check recommendations, try bulk actions!

๐Ÿ“– Usage

View Statistics

  • See total tabs, windows, inactive count
  • Browse tabs sorted by age, usage, or activity
  • Click any tab to switch to it instantly

Find Tabs Fast

  • Search by title or URL in dashboard
  • Filter by: all, inactive, rarely used, duplicates
  • Sort by: age, frequency, or title

Clean Up Tabs

  1. Open dashboard โ†’ Tab List
  2. Use filters to find candidates
  3. Try bulk actions:
    • Close Inactive Tabs - Remove tabs unused for 7+ days
    • Close Duplicates - Keep one, remove others
    • Close Selected - Check specific tabs

Analyze by Domain

  • Dashboard โ†’ Domains tab
  • See which sites have most tabs
  • Manage all tabs from a domain at once

Customize Settings

  • Dashboard โ†’ Settings
  • Change inactivity threshold (default: 7 days)
  • Set data retention period (default: 30 days)
  • Export your data as JSON

๐ŸŽจ Screenshots

Side Panel (Chrome)

Quick access to tab statistics with sortable lists and instant actions.

Dashboard Overview

Beautiful charts showing domain distribution and tab age visualization.

Tab Management

Advanced filtering, search, and bulk actions for efficient tab cleanup.

๐Ÿ”ง Technical Details

  • Manifest V3 - Latest Chrome extension standard
  • Vanilla JavaScript - No framework dependencies
  • Chart.js - Beautiful data visualizations
  • Chrome APIs - tabs, storage, sidePanel, windows
  • Local Storage - All data stored on your device

๐Ÿ” Privacy & Security

โœ… 100% Local - All data stored on your device
โœ… No Tracking - Zero analytics or telemetry
โœ… No Network - No external requests
โœ… Open Source - Audit the code yourself
โœ… Minimal Permissions - Only what's necessary

Required Permissions

  • tabs - Read tab information (title, URL)
  • storage - Store statistics locally
  • sidePanel - Display side panel in Chrome
  • <all_urls> - Access favicons for visual display

๐ŸŽฏ Use Cases

  • Tab Hoarders - Finally understand your tab chaos
  • Productivity - Close distractions, keep what matters
  • Research - Track which tabs you actually use
  • Memory Management - Reduce browser memory usage
  • Digital Minimalism - Maintain a clean workspace

๐Ÿ› ๏ธ Development

Project Structure

browser-tab-stats/
โ”œโ”€โ”€ manifest.json          # Extension configuration
โ”œโ”€โ”€ background/            # Service worker (tab tracking)
โ”œโ”€โ”€ sidepanel/            # Quick view interface
โ”œโ”€โ”€ dashboard/            # Full analytics dashboard
โ”œโ”€โ”€ shared/               # Utilities, stats, storage
โ”œโ”€โ”€ assets/icons/         # Extension icons
โ””โ”€โ”€ lib/                  # Chart.js library

Making Changes

  1. Edit source files
  2. Go to chrome://extensions/
  3. Click reload button on Tab Stats
  4. Test your changes

Browser Support

  • Chrome 109+ โœ… (Side Panel + Full Dashboard)
  • Brave โœ… (Dashboard only - Side Panel not supported)
  • Edge ๐Ÿ”„ (Should work, untested)
  • Firefox โŒ (Future - needs WebExtensions adaptation)

๐Ÿ“ Known Limitations

  • Initial tracking: Tabs opened before extension install show current time as creation time (browser API limitation)
  • Incognito tabs: Not tracked by design (privacy)
  • Chrome internal pages: Limited tracking for chrome:// URLs
  • Side Panel: Only available in Chrome 114+, not in Brave

๐Ÿ—บ๏ธ Roadmap

โœ… Completed

  • Keyboard shortcuts (โŒ˜R, โŒ˜E, โŒ˜K, โŒ˜1-4)
  • Tab Health Score (0-100 per tab)
  • Session tracking (daily opens/closes)
  • Weekly trend visualization
  • Linear-style minimalist UI

๐Ÿ”œ Tier 2 (Next Up)

  • Memory usage estimates per tab
  • Tab grouping suggestions by domain/topic
  • "Focus Mode" - hide all but essential tabs
  • Tab age distribution chart
  • Productivity score trends over time

๐Ÿ”ฎ Tier 3 (Future)

  • Firefox & Edge support
  • Session management (save/restore tab sets)
  • Scheduled auto-cleanup rules
  • Dark mode theme
  • Tab preview on hover
  • Bookmark integration
  • CSV export format
  • Undo for bulk actions

๐Ÿค Contributing

Contributions welcome! Please feel free to submit issues or pull requests.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

๐Ÿ“„ License

MIT License - feel free to use and modify as needed.

๐Ÿ™ Acknowledgments

  • Built with Chrome Extension APIs
  • Visualizations powered by Chart.js
  • Inspired by tab management frustrations everywhere

๐Ÿ“ฌ Support

Found a bug? Have a feature request?

  • Open an issue on GitHub
  • Check existing issues first
  • Include browser version and error messages

Made with โค๏ธ for better tab management

Stop pretending you'll go back to those 47-day-old tabs. Track them, analyze them, close them. ๐Ÿš€

About

๐Ÿ—‚๏ธ Because 147 tabs is too many. Track, analyze, and actually manage your browser tabs with stats, insights, and smart cleanup recommendations.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published