LinkSanitizer

About

# LinkSanitizer — Chrome Extension

A lightweight, high-performance Manifest V3 Chrome extension that automatically strips tracking parameters from URLs **before** the page loads — protecting your privacy silently in the background. 

Designed with a sleek, minimalist dark UI, LinkSanitizer blocks analytics, social media, and advertising trackers in real-time, keeping your browsing fast and clean.

---

## ✨ Key Features

* **Real-Time Sanitization:** Instantly intercepts and purges URLs before the browser requests the page.
* **Global Counter & Icon Badge:** Live activation counter showing exactly how many tracking parameters have been stripped.
* **User-Customizable Allowlist:** Easily whitelist specific domains (e.g., `amazon.it`, `ebay.it`) directly from the popup if you need tracking active for specific sites.
* **Master On/Off Toggle:** Pause and resume the extension globally with a single click, featuring a responsive color-coded visual indicator (Green for Active, Red for Paused).
* **100% Local & Private:** No data is ever sent to external servers. All settings and counts are kept strictly on your machine via `chrome.storage.local`.

---

## 🛡️ Supported Tracking Parameters

LinkSanitizer automatically detects and removes a comprehensive list of tracking tokens, including:

| Parameter | Source / Platform |
|-----------|-------------------|
| `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content` | Google Analytics / UTM |
| `fbclid` | Facebook / Meta |
| `gclid`, `gclsrc`, `dclid`, `gbraid`, `wbraid` | Google Ads & iOS Privacy Bypass |
| `msclkid` | Microsoft Ads / Bing |
| `twclid` | Twitter / X |
| `igshid` | Instagram |
| `mc_eid`, `mc_cid` | Mailchimp Campaigns |
| `_ga`, `_gl` | Google Analytics Linkers |
| `zanpid`, `yclid` | Zanox Affiliates, Yandex |

---

## 📂 Project Architecture

```text
link-sanitizer/
├── manifest.json   — Extension configuration (MV3 permissions & icons configuration)
├── background.js   — Service worker: background link interception & synchronization logic
├── content.js      — Content script: handles instant client-side URL updates
├── popup.html      — Responsive popup interface
├── popup.css       — Custom minimalist dark-theme stylesheet
├── popup.js        — Live counter rendering, toggle management & allowlist sync
└── icons/          — Cyberpunk official identity artwork
    ├── icon16.png  (Toolbar icon)
    ├── icon48.png  (Extensions management page icon)
    └── icon128.png (Chrome Web Store display icon)
    
```