Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 

Repository files navigation

Ghost Clean – Firefox Privacy Cleaner

One click. Firefox wiped clean.

Ghost Clean is a lightweight Firefox extension for quickly clearing browser data without digging through Firefox settings.

It gives you a simple dashboard for common browser data, lets you clean everything at once or target a single website, protects selected site cookies with a whitelist, and can automatically clean on a schedule.

✨ Features

  • 🧹 One-click Clean All
  • 📊 Live browser-data dashboard
  • 🍪 Cookie whitelist so selected sites stay logged in
  • 🎯 Clean the current website only
  • ⏱️ Automatic cleaning schedules
    • Off
    • Daily
    • Weekly
    • On browser startup
  • 🗂️ View counts for history, cookies, and downloads
  • Clear Firefox cache
  • 💾 Clear local storage and IndexedDB
  • 🔑 Clear saved passwords
  • 📥 Clear download history
  • 📈 Local lifetime cleanup counter
  • 🚀 Lightweight background cleaning engine
  • 🧼 Fresh-browser restart after Clean All

🖥️ Dashboard

Ghost Clean's popup provides a compact dashboard for the main Firefox data categories:

Data Type Dashboard Clean All Individual Clean
History ✅ Count
Cookies ✅ Count ✅* ✅*
Downloads ✅ Count
Cache ℹ️
Local Storage ℹ️
IndexedDB ℹ️
Passwords ℹ️

* Whitelisted domains are preserved when cookies are cleared.


🧹 Clean All

Clean All runs Ghost Clean's shared background cleaning engine and removes:

  • Browsing history
  • Cookies, except cookies belonging to whitelisted domains
  • Firefox cache
  • Local storage
  • IndexedDB
  • Download history
  • Saved passwords

After a successful full clean, Ghost Clean:

  1. Opens a fresh Firefox tab.
  2. Closes the other open tabs.
  3. Shows a completion/support prompt.

This gives you a clean starting point without manually closing tabs or navigating through Firefox's privacy settings.


🎯 Clean This Site

Ghost Clean can clean the website currently open in your active Firefox tab.

Site cleaning removes data associated with that hostname, including:

  • Cookies
  • Local storage
  • IndexedDB
  • Service worker registrations

It does not clear the browser's global cache because Firefox does not provide hostname-filtered cache removal through the browsing-data API.

Use Clean All when you need a complete browser-wide cleanup.


🍪 Cookie Whitelist

Some sites need their cookies preserved so you don't have to sign in again after every cleanup.

Ghost Clean includes a local cookie whitelist where you can:

  • Add a domain manually
  • Add the currently open site
  • Remove domains from the whitelist
  • Keep matching cookies during Clean All
  • Keep matching cookies during automatic scheduled cleaning

Whitelist entries are stored locally in Firefox extension storage.

Example

Adding:

github.com

will preserve cookies for:

github.com
www.github.com
gist.github.com

while other cookies can still be removed.


⏱️ Automatic Cleaning

Ghost Clean can run the same full-cleaning engine automatically in the background.

Available modes:

Mode Behavior
Off Only clean manually
Daily Clean once every 24 hours
Weekly Clean once every 7 days
On browser start Clean whenever Firefox starts

The cookie whitelist is respected by automatic cleaning as well.

Ghost Clean also records the last automatic-clean time locally so the schedule screen can show when the last run occurred.


📈 Lifetime Cleanup Counter

Ghost Clean maintains a local items cleaned counter.

The counter is based on countable browser records removed during cleaning:

  • History entries
  • Cookies removed
  • Download history entries

This statistic is stored locally on the device and is not included in Ghost Clean's telemetry.


🔐 Privacy

Ghost Clean is designed to keep the browser data it cleans on the user's device.

What Ghost Clean does not collect

Ghost Clean does not send:

  • Browsing history
  • Website URLs
  • Cookies
  • Saved passwords
  • Download activity
  • Local storage contents
  • IndexedDB contents
  • Page contents
  • Search queries
  • The lifetime cleanup counter
  • Ip address
  • Geo location
  • Nothing Personal at all

Anonymous active-user telemetry

Ghost Clean includes a small, privacy-preserving active-user heartbeat.

For usage monitoring and reliability purposes, the extension:

  1. Generates one random anonymous UUID on the device.
  2. Stores that UUID locally.
  3. Sends the opaque UUID to the project's telemetry endpoint at most approximately once per day.
  4. Uses the server-side last_seen timestamp to measure active users over a rolling period.

The heartbeat does not send browsing activity, page URLs, passwords, cookies, download information, or the cleanup counter.

The anonymous identifier is not accompanied by an extension-version history, browser fingerprint, or page-level activity in the heartbeat payload.

If the extension is uninstalled, the heartbeat stops and the anonymous record naturally ages out of the active-user window.


🧩 Permissions

Ghost Clean requests Firefox permissions required for its cleaning and management features:

Permission Why it is needed
history Read and remove browsing history
cookies Inspect and selectively remove cookies
browsingData Clear cache, storage, passwords, downloads, and other Firefox data
tabs Detect the active site and close tabs after a full cleanup
activeTab Access the active tab for site-specific cleaning
downloads Count and clear download history
sessions Support Firefox session-related extension functionality
storage Store whitelist, schedule, local statistics, anonymous ID, and update state
alarms Run scheduled cleaning and the daily privacy-preserving heartbeat
<all_urls> Required for site-wide cookie/site-data management

Ghost Clean's background code performs the actual cleanup so the same cleaning logic is used for both manual and scheduled operations.


📦 Installation

Install Ghost Clean from Firefox Add-ons:

👉 https://addons.mozilla.org/en-US/firefox/addon/ghost-clean/


If Ghost Clean saves you some time, you can support the project:

👉 https://buymeacoffee.com/udaysheth


👤 Author

Uday Sheth

Built for fast, practical Firefox cleanup and privacy-focused browser maintenance.

About

Ghost Clean is a firefox extension that instantly clears your browsing data like history, cookies, cache, downloads, passwords, and more and then opens a fresh new tab after cleanup. One click and your browser is wiped clean.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors