Skip to content

iamqitmeer/instant-url-cleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

✨ Instant URL Cleaner Pro ✨

License: MIT

Magically cleans tracking parameters (UTM, fbclid, gclid, etc.) from URLs instantly. Share cleaner links and enhance your privacy effortlessly! 100% Private & Client-Side.

This Chrome Extension automatically detects and removes common tracking parameters from URLs you copy or right-click, ensuring you share clean, clutter-free links without leaking unnecessary data.


πŸš€ Key Features

  • 🧹 Automatic Cleaning: Removes dozens of known tracking parameters (like utm_*, fbclid, gclid, msclkid, mc_eid, igshid, and many more) from URLs.
  • πŸ–±οΈ Context Menu Integration: Right-click any link and select "✨ Clean & Copy Link Address" for instant cleaning and copying.
  • πŸ“‹ Clipboard Monitoring (Optional): Automatically cleans URLs copied to the clipboard (can be toggled in settings).
  • βš™οΈ Intuitive Popup UI:
    • Paste URLs for manual cleaning.
    • View the original and cleaned URLs side-by-side.
    • Access cleaning history (last 7 cleaned URLs).
    • Toggle Auto-Paste & Auto-Clean settings.
    • Dark Mode support! πŸŒ“
  • πŸ”’ 100% Privacy Focused: All processing happens locally in your browser. No data is ever sent to any server. We collect nothing.
  • ⚑ Lightweight & Fast: Built with Manifest V3 for optimal performance. Won't slow down your browsing.
  • πŸ”§ Customizable: Add your own custom tracking parameters to the blocklist via the Options page.
  • ✨ Clean & Modern UI: Uses Remix Icons for a sleek look.
  • ❀️ Free & Open Source: Completely free to use, with source code available for transparency and contribution.

πŸ€” Why Use Instant URL Cleaner Pro?

  • Protect Your Privacy: Stop inadvertently sharing tracking information about where you clicked from or which campaign you responded to.
  • Share Cleaner Links: Long URLs with tracking codes are messy and unprofessional. Share short, clean links that are easier to read and trust.
  • Reduce URL Clutter: Keep your copied links tidy, especially useful for notes, documents, or sharing in character-limited platforms.
  • Effortless Operation: Works seamlessly in the background or with a simple right-click. Set it and forget it!

πŸ’Ύ Installation

There are two ways to install Instant URL Cleaner Pro:

1. From the Chrome Web Store (Recommended):

2. Manual Installation (For Developers or Testing):

  • Download the latest release OR clone this repository:
    git clone https://github.com/iamqitmeer/instant-url-cleaner.git
  • Open Google Chrome and navigate to chrome://extensions/.
  • Enable "Developer mode" using the toggle switch in the top-right corner.
  • Click the "Load unpacked" button.
  • Select the directory where you downloaded or cloned the repository (the folder containing manifest.json).
  • The extension should now be loaded and visible in your toolbar.

πŸ’‘ How to Use

  1. Automatic (if enabled): Simply copy a URL (Ctrl+C / Cmd+C) that contains tracking parameters. If "Auto-Clean & Copy" is enabled in the popup settings, the cleaned URL will automatically replace the original in your clipboard.
  2. Context Menu: Right-click on any hyperlink on a webpage. Click "✨ Clean & Copy Link Address" from the context menu. The cleaned URL will be copied to your clipboard.
  3. Popup:
    • Click the ✨ extension icon in your Chrome toolbar.
    • Paste & Clean: Paste a URL into the input box and click "Clean This URL".
    • View Results: See the original and cleaned versions. Click the copy icon next to the cleaned URL.
    • History: See recently cleaned URLs. Click one to load it again.
    • Settings: Toggle Auto-Paste and Auto-Clean behaviours. Toggle Dark Mode.
    • Privacy Note: Reminds you that cleaning is done locally.
  4. Options Page:
    • Right-click the extension icon and select "Options" (or find it via chrome://extensions/).
    • View the built-in list of blocked parameters.
    • Add your own custom tracking parameters to remove (one per line).

πŸ›‘οΈ Privacy Policy

Your privacy is paramount.

  • Instant URL Cleaner Pro processes all URLs locally on your computer within the Chrome browser.
  • No URL data, tracking parameters, browsing history, or any other personal information is ever collected, stored remotely, or transmitted to any external servers.
  • The extension only requires minimal permissions (storage to save your settings/history locally, clipboardRead/clipboardWrite for core functionality activated by you, contextMenus for the right-click feature, offscreen for background clipboard access).
  • The source code is open for review on GitHub.

πŸ’» Technology Stack

  • Google Chrome Extension Manifest V3
  • JavaScript (ES6+)
  • HTML5
  • CSS3
  • Remix Icons

πŸ™Œ Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

If you'd like to contribute, please fork the repository and create a pull request.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.

(Note: You should create a file named LICENSE in your repository root and add the standard MIT License text to it).


Made with ❀️ by Qitmeer Raza

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published