Skip to content

Add-on to clear browser cache with a single click or via the F9 key.

License

TenSoja/clear-cache

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

74 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Firefox v4.4 Version 4.4 WebExtensions API JavaScript ES6 HTML5 CSS3

Clear Cache Icon

Clear Cache

Add-on to clear browser cache with a single click or via the F9 key.

๐Ÿ“ฑ Now available on Firefox for Android!

License Stars Forks Issues Last Commit Firefox Users Rating Mozilla Recommended

๐Ÿ”’ Security & Privacy First

โœ… Zero Data Collection - No personal data collected or transmitted
โœ… Minimal Permissions - Only requests necessary permissions
โœ… Local Storage Only - All preferences stored locally on your device
โœ… Open Source - Fully transparent code for security review
โœ… Mozilla Verified - Follows Mozilla's strict security guidelines

๐Ÿ†• What's New in v4.4

โฐ Time Period Selection

Choose exactly what timeframe to clear:

  • 15 minutes - Clear recent browsing only
  • 1 hour - Clear last hour of activity
  • 24 hours - Clear today's browsing
  • 1 week - Clear weekly activity
  • All time - Traditional full cache clear

๐ŸŽฏ Current Tab Only

New precision clearing mode:

  • Clear data only for the active tab
  • Perfect for developers working on specific sites
  • Preserves other sites' data while testing
  • Uses origin-based filtering for targeted cleaning

๐ŸŽจ Enhanced Context Menu

Right-click the extension icon for:

  • Clear Cache & Reload - One-click action that always reloads
  • Quick access to key functions
  • Streamlined workflow for power users

โœจ Features

  • ๐Ÿš€ One-click cache clearing - Clear cache instantly with toolbar button
  • โŒจ๏ธ Keyboard shortcut - Default F9 key (customizable)
  • ๐ŸŽฏ Selective clearing - Choose what to clear (cache, cookies, history, etc.)
  • โฐ Time-based clearing - Clear data from last 15min, 1hour, 24hours, 1week, or all time
  • ๐ŸŽฏ Current tab only - Option to clear data only for active tab
  • ๐Ÿ”„ Auto-reload - Automatically reload page after clearing (configurable)
  • ๐Ÿ”” Notifications - Optional confirmation notifications
  • ๐ŸŒ Multi-language - Support for 8 languages
  • ๐ŸŽจ Context menu - Right-click extension icon for quick actions

๐Ÿš€ Quick Start

  1. Install the extension from Firefox Add-ons Store
  2. Click the broom icon in your toolbar
  3. Customize settings via right-click โ†’ Options
  4. Use F9 for quick cache clearing

๐Ÿ’ก Tip: Right-click the extension icon for context menu options!

๐Ÿ“ธ Screenshots & Usage

๐ŸŽ›๏ธ Options Page - Complete Control

Configure all aspects of cache clearing to fit your workflow:

Options Page

Configure data types, time periods, and behavior settings

โฐ Time Period Selection (NEW in v4.4)

Choose exactly what timeframe to clear:

Time Period Options

Select from 15 minutes, 1 hour, 24 hours, 1 week, or all time

๐ŸŽฏ Current Tab Only (NEW in v4.4)

Clear data only for the active tab:

Current Tab Only

Perfect for developers working on specific sites

๐Ÿงน Toolbar Integration

Simple, clean interface:

Toolbar Button

One-click access from Firefox toolbar

๐Ÿ”” Smart Notifications

Get informed about what was cleared:

Smart Notification

Shows what data types and time period were cleared

๐Ÿ’ป Development

Prerequisites

Installation for Development

  1. Clone the repository:

    git clone https://github.com/TenSoja/clear-cache.git
    cd clear-cache
  2. Load the extension in Firefox:

    • Open Firefox Developer Edition
    • Navigate to about:debugging
    • Click "This Firefox"
    • Click "Load Temporary Add-on"
    • Select the manifest.json file from the cloned repository
  3. Test the extension:

    • Click the Clear Cache icon in the toolbar
    • Or press F9 (default keyboard shortcut)
    • Access options via about:addons > Clear Cache > Preferences
    • Try different time period options (All time, Last 15 minutes, Last hour, etc.)

Project Structure

clear-cache/
โ”œโ”€โ”€ manifest.json          # Extension configuration
โ”œโ”€โ”€ background.js          # Background script handling cache clearing
โ”œโ”€โ”€ options/              # Settings page
โ”‚   โ”œโ”€โ”€ options.html      # Options page HTML
โ”‚   โ”œโ”€โ”€ options.js        # Options page logic
โ”‚   โ””โ”€โ”€ options.css       # Options page styling
โ”œโ”€โ”€ _locales/             # Internationalization files
โ”‚   โ”œโ”€โ”€ en/               # English translations
โ”‚   โ””โ”€โ”€ .../              # Other language translations
โ”œโ”€โ”€ icons/                # Extension icons
โ””โ”€โ”€ README.md             # This file

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Test your changes in Firefox Developer Edition
  4. Ensure your changes follow Mozilla's WebExtension guidelines
  5. Submit a pull request with a clear description of changes

Permissions Explained

  • browsingData: Required to clear browser cache and other browsing data
  • notifications: Used to show confirmation when cache is cleared
  • storage: Used to save user preferences locally
  • contextMenus: Enables right-click menu options
  • tabs: Needed to detect the currently active tab when using the "Current Tab Only" option, so browsing data is cleared only for that site instead of the entire browser

๐Ÿค Contributors

Thanks to all contributors who helped improve this project!

Project Creator & Lead Developer:

  • Michel de Almeida Silva (@TenSoja) - Creator & Primary Maintainer

Special Thanks to Contributors:

  • Heimen Stoffels - Added Dutch translation
  • zer0-x - Added Arabic localization
  • Tomรกลก Berรกnek - Added Czech language support
  • medwuu - Added Russian localization
  • Ariel Xinyue Wang - File contributions & improvements

๐Ÿ›ฃ๏ธ Roadmap

๐ŸŽฏ #1 Priority: Site-Specific Cleaning

Goal: $30 on Buy Me a Coffee - ๐Ÿ“‹ Track Progress on Issue #24

  • Domain-based filtering (e.g., clear only github.com data)
  • Selective data types per site (cache, cookies, localStorage)
  • Favorite sites list for quick access
  • Advanced site management interface

๐Ÿ”ฎ Future Features

  • Chrome/Edge support
  • Scheduled automatic clearing
  • Integration with dev tools
  • Custom keyboard shortcuts
  • Dark theme for options page
  • Export/Import settings
  • Bulk site operations
  • Developer tools integration

๐Ÿ“ˆ Usage Impact

This extension has helped thousands of developers save time by:

  • โšก Reducing cache clearing time from 5+ clicks to 1 click
  • ๐Ÿ”„ Automating the reload process
  • ๐ŸŽฏ Providing granular control over what gets cleared
  • โฐ Offering time-based clearing options

โ˜• Support the Project

๐Ÿ’ Use the "โค๏ธ Sponsor" button above to support this project directly via Buy Me a Coffee!

๐ŸŽฏ Current Goal: Site-Specific Cleaning ($30)
Help unlock targeted data cleaning - clear cache, cookies, and storage for specific websites only!

Funding Progress

Your contribution helps maintain and improve this project for thousands of developers worldwide. Thank you! ๐Ÿ™


As we say in Brazil:
๐Ÿงน Diga onde vocรช vai, que eu vou varrendo, varrendo, varrendo...
โ€” Molejo

Made with โค๏ธ by Michel de Almeida Silva
๐Ÿ‡ง๐Ÿ‡ท๐ŸŒฟ Amazon | ๐Ÿงน Cleaning the web, one cache at a time

About

Add-on to clear browser cache with a single click or via the F9 key.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 5