Skip to content

Releases: dominhduy09/advanced-cookie-manager

🍪 Advanced Cookie Manager Extension V.1.1.0

06 Jan 02:53
98bf4ec

Choose a tag to compare

🍪 Advanced Cookie Manager

A modern, feature-rich browser extension for managing cookies with beautiful glassmorphism UI

Version
License
Manifest V3
Chrome Extension
PRs Welcome

FeaturesInstallationUsageTech StackContributing


📑 Table of Contents


🎯 Overview

Advanced Cookie Manager is a modern Chrome extension built with Manifest V3 that empowers developers and power users to manage browser cookies with precision and elegance. Whether you're debugging authentication flows, testing cookie behavior, or managing session data, this extension provides an intuitive interface with powerful features like import/export, encryption, and password protection.

Who is this for?

  • 👨‍💻 Web developers testing cookie-based authentication
  • 🔒 Security professionals auditing cookie configurations
  • 🧪 QA engineers managing test environments
  • 💼 Anyone needing fine-grained cookie control

Why it exists:
Chrome's built-in cookie management is limited. This extension fills that gap with a developer-friendly UI, multi-format import/export, and security features like AES-256-GCM encryption—all without external dependencies or privacy concerns.


✨ Features

🔍 Core Cookie Management

  • View Cookies — Display all cookies for current domain or all domains at once
  • Add Cookies — Create new cookies with full control over name, value, domain, path, expiration, and flags
  • Edit Cookies — Modify existing cookie values and settings in real-time
  • Delete Cookies — Remove individual cookies or clear all with a single click
  • Search & Filter — Quickly find cookies by name, value, or domain using live search
  • Sort Options — Sort by name, domain, or expiration date for easier navigation

📤 Import/Export

  • JSON Format — Import and export cookies as structured JSON
  • Header String — Parse and generate cookie header strings (key=value pairs)
  • Netscape Format — Full support for Netscape cookie file format (standard .txt files)
  • Encryption Support — Encrypt exported cookies with AES-256-GCM for secure sharing
  • Decryption — Import encrypted cookies with password protection

🔐 Security

  • Password Protection — Optional lock extension with SHA-256 hashed passwords
  • Auto-Lock — Automatically lock after configurable inactivity period
  • Export Encryption — AES-256-GCM encryption with random salt and IV
  • PBKDF2 Key Derivation — 100,000 iterations for strong password-based encryption
  • No Cloud Storage — All processing happens locally; no external requests

🎨 User Experience

  • Glassmorphism Design — Modern frosted glass aesthetic
  • Dark/Light Themes — Toggle between themes with persistent settings
  • Smooth Animations — CSS transitions for polished interactions
  • Toast Notifications — Real-time success and error feedback
  • Copy to Clipboard — One-click copy for cookie values and headers

⚙️ How It Works

Architecture Overview

┌─────────────────────────────────────────────────────────┐
│          Chrome Extension (Manifest V3)                  │
├─────────────────────────────────────────────────────────┤
│                                                           │
│  ┌──────────────────────────────────────────────────┐   │
│  │         Popup UI (popup.html/css/js)             │   │
│  │  • Cookie viewing & management                   │   │
│  │  • Import/Export modals                          │   │
│  │  • Settings & password lock                      │   │
│  └──────────────────────────────────────────────────┘   │
│                        ↕                                 │
│  ┌──────────────────────────────────────────────────┐   │
│  │      Background Service Worker (background.js)   │   │
│  │  • Message relay & communication                 │   │
│  │  • Password hashing (SHA-256)                    │   │
│  │  • Auto-lock timer management                    │   │
│  └──────────────────────────────────────────────────┘   │
│                        ↕                                 │
│  ┌──────────────────────────────────────────────────┐   │
│  │          Utility Modules (utils/)                 │   │
│  │  • storage.js — Chrome storage wrapper           │   │
│  │  • cookieParser.js — JSON/Header parsing         │   │
│  │  • netscapeParser.js — Netscape format support   │   │
│  │  • crypto.js — AES-256-GCM encryption            │   │
│  └──────────────────────────────────────────────────┘   │
│                        ↕                                 │
│  ┌──────────────────────────────────────────────────┐   │
│  │       Chrome APIs                                 │   │
│  │  • chrome.cookies — Query & set cookies          │   │
│  │  • chrome.tabs — Get active tab info             │   │
│  │  • chrome.storage.local — Persistent settings    │   │
│  │  • chrome.runtime — Message passing              │   │
│  └──────────────────────────────────────────────────┘   │
│                                                           │
└─────────────────────────────────────────────────────────┘

Data Flow:

  1. User interacts with popup UI
  2. Popup communicates with background service worker via chrome.runtime.sendMessage()
  3. Service worker handles sensitive operations (hashing, password checks)
  4. Utilities parse and encrypt/decrypt data as needed
  5. Chrome APIs fetch/modify cookies and store settings

📦 Installation

Quick Start (Development Mode)

  1. Clone or download this repository:

    git clone https://github.com/dominhduy09/advanced-cookie-manager.git
    cd advanced-cookie-manager
  2. Open Chrome/Edge and navigate to chrome://extensions/

  3. Enable Developer Mode (toggle in top-right corner)

  4. Click "Load unpacked" and select the advanced-cookie-manager folder

  5. Verify the extension icon appears in your toolbar

Create Icons (Optional but Recommended)

The extension requires three PNG icon files. See icons/README.md for detailed instructions on:

  • Using the icon generator
  • Creating custom icons with design tools
  • Using emoji-based icons

🚀 Usage

Basic Operations

  1. View Cookies

    • Click the extension icon to open the popup
    • See all cookies for the current website
    • Toggle "All Domains" checkbox to view cookies across all websites
  2. Search & Filter

    • Use the search bar to filter by cookie name, value, or domain
    • Search is live and case-insensitive
  3. Sort

    • Click the sort dropdown to organize by:
      • Name (alphabetical)
      • Domain
      • Expiration date

Adding a Cookie

  1. Click "➕ Add Cookie" button
  2. Fill in required fields:
    • Name — Cookie identifier
    • Value — Cookie content
  3. Optionally set:
    • Domain — Cookie scope (e.g., .example.com)
    • Path — URL path restriction (default: /)
    • Expiration — Date/time for cookie expiry
    • Secure — HTTPS only
    • HttpOnly — JavaScript access restriction
    • SameSite — CSRF protection (Strict/Lax/None)
  4. Click "Save"

Editing a Cookie

  1. Click the "✏️" icon on any cookie
  2. Modify the desired fields
  3. Click "Save"

Deleting Cookies

  • Single cookie: Click the "🗑️" icon on the cookie row
  • All cookies: Click "🗑️ Clear All" (confirmation required)

Importing Cookies

  1. Click "📥 Import" button
  2. Select import format:
    • JSON — Structured cookie array
    • Header String — Semi-colon separated key=value pairs
    • Netscape — Standard cookie file format
  3. Paste or select your cookie data
  4. If encrypted, enter the decryption password
  5. Click "Import"

Examples:

JSON:

[
  {
    "name": "session_id",
    "value": "abc123xyz",
    "domain": ".example.com",
    "path": "/",
    "expirationDate": 1735689600,
    "secure": true,
    "httpOnly": false,
    "sameSite": "Lax"
  }
]

Header String:

session_id=abc123xyz; user_token=xyz789; theme=dark

Netscape:

# Netscape HTTP Cookie File
# This is a generated file!  Do not edit.

.example.com	TRUE	/	TRUE	1735689600	session_id	abc123xyz
.example.com	TRUE	/	FALSE	1735689600	user_token	xyz789

Exporting Cookies

  1. Click "📤 Export" button
  2. Select export format (JSON, Header String, or Netscape)
  3. Optional: Enter a password to encrypt the export
  4. Choose action:
    • "📋 Copy" — Copy encrypted/plaintext to clipboard
    • "💾 Download" — Save as file to your computer

Encryption Details:

  • Uses AES-256-GCM encryption algorithm
  • Derives key from password using PBKDF2...
Read more