Skip to content

cacan/TabSessionManager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🗂️ Tab Session Manager 2.0

Manifest V3 License Version

Never lose your tabs again. A powerful, efficient, and privacy-focused Chrome Extension that automatically saves your browser sessions, ensuring you can always pick up where you left off. Now with a completely modernized Dark/Light UI and advanced session management tools.


📖 Overview

Tab Session Manager is designed for power users who juggle multiple projects and hundreds of tabs. It works silently in the background, capturing the state of your windows and tabs. With version 2.0, we've introduced Session Locking, Batch Operations, Theming, and a beautiful new interface to help you organize your digital life.

✨ Key Features

🎨 Modern UI & Experience

  • Dark & Light Mode: Switch between a sleek dark theme (default) and a clean light theme with a single click.
  • Visual Overhaul: A complete redesign with vibrant gradients, card-based layouts, and modern iconography.
  • Responsive: Optimized layout that ensures no horizontal scrolling issues.

🛡️ Smart Protection & Locking

  • Session Locking: Lock specific sessions to prevent them from being auto-deleted or purged.
  • Generic Lock Button: Easily toggle lock status directly from the session header.

🧹 Advanced Maintenance & Purging

  • Smart Purging: Automatically maintains history based on retention policies.
  • Manual Purge Tools:
    • Purge Daily: Keeps only the last session of each day (plus locked sessions).
    • Purge Monthly: Keeps only the last session of each month (plus locked sessions).
  • Remove Duplicates: Instantly scan all unlocked sessions and remove duplicate URLs within each session to declutter.

🔍 Search & Batch Actions

  • Real-Time Filtering: Instantly filter tabs and sessions by URL as you type.
  • Delete Matched: Delete all tabs matching a search term across all unlocked sessions with one click.
  • Move Matched: Organize your chaos! Move all tabs matching a search term into a new dedicated window within their respective sessions.

💾 Robust Data Management

  • Smart Auto-Save: Triggers only on new tab/window creation (ignoring navigation). Includes a 5-second debounce to group rapid actions and 15-minute silence during session restores to prevent history spam.
  • Manual Save: One-click manual save button.
  • Import/Export: detailed JSON import/export for backup and migration.
  • Unlimited Storage: Stores as much history as your disk permits.

🚀 Installation

  1. Clone the Repository

    git clone https://github.com/cacan/TabSessionManager.git
  2. Open Chrome Extensions

    • Navigate to chrome://extensions/
    • Toggle Developer mode (top right).
  3. Load the Extension

    • Click Load unpacked.
    • Select the project directory.
  4. Pin & Enjoy


🕹️ Usage Guide

The Dashboard

  • Toggle Theme: Click the ☀️/🌙 icon to switch themes.
  • Search: Type in the search bar to filter sessions and tabs.
  • Save: Click "Save Session" to snapshot your current state.

Managing Sessions

  • Expand: Click the session header or arrow .
  • Lock: Click the 🔓/🔒 icon to protect a session.
  • Actions:
    • Restore: Opens all windows/tabs.
    • Export: Downloads session as JSON.
    • Delete: Removes the session (requires confirmation).
    • Move Filtered: (Visible when searching) Moves matching tabs to a new window.

Maintenance Area

  • Purge Daily/Monthly: Runs the retention algorithm manually.
  • Remove Duplicates: Cleans up redundant tabs inside sessions.

📝 Changelog

v2.0.0

  • New: Complete UI Rewrite with popup.css and Modern Design System.
  • New: Light/Dark Theme Switcher.
  • New: "Move Filtered to New Window" feature.
  • New: "Remove Duplicates" maintenance tool.
  • New: Session Locking mechanism to prevent accidental deletion.
  • New: Manual "Purge Daily" and "Purge Monthly" buttons.
  • Improved: Search functionality with batch delete/move actions.
  • Improved: Auto-save logic refined:
    • Removed "onUpdated" listener (no more saving on every page load).
    • Added 5-second debounce to group tab creation events.
    • Added 15-minute "Silence" mode during chrome startup and manual restores.
  • Improved: Auto-save logic ignores internal Chrome pages (chrome://, chrome-extension://).
  • Fixed: Horizontal scrollbar issues.
  • Fixed: "Unlock" terminology updated to "Unlocked".

🏗️ Technical Details

  • Framework: Native Chrome Extension API (Manifest V3).
  • Storage: chrome.storage.local with unlimitedStorage.
  • Background Worker: Service worker-based background script.

📄 License

Distributed under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published