ImageSwap

About

🖼️ ImageSwap - Smart Placeholder Image Replacement 🖼️

A must-have Chrome extension for web developers and designers! Instantly replace all webpage images with beautiful, randomly-generated Picsum photos while maintaining original dimensions. Perfect for testing layouts, debugging designs, and visualizing page structures.

✨ Key Features:
🎨 Intelligent Image Replacement: Automatically swaps all images with high-quality Picsum photos while preserving original dimensions for pixel-perfect layouts.

🔀 Flexible Replacement Modes: Set a Global mode — "Replace All" or "Failed Images Only" — and optionally override it per-URL with Default, Replace All, or Failed Only for fine-grained control over each site.

🎯 Smart Consistency: Generates stable seeds from image attributes (alt text, ID, class) ensuring the same image always gets the same placeholder across page reloads—no flickering!

⚡ Dynamic Content Support: MutationObserver technology handles lazy-loaded images, infinite scroll, and single-page applications seamlessly.

🎛️ Whitelist Control: Exclude specific images from replacement using any CSS selector—.class, #id, or nested selectors like .parent img—perfect for preserving logos and critical assets.

🌐 Active URL Filtering: Control which websites the extension runs on with wildcard pattern support (e.g., *://*.example.com/*). Each URL entry supports inline editing and an individual replacement mode override—site-specific customization at your fingertips.

🎨 Custom CSS Injection: Add your own CSS rules to enhance image visibility with built-in sanitization for security.

💾 Persistent Settings: All preferences sync across browser sessions using Chrome Sync for a consistent workflow.

⚡ Performance Optimized: Efficiently tracks processed images to avoid redundant operations with minimal performance impact.

🔒 Privacy First: Zero data collection or tracking. All settings stored locally in your browser. Open source and transparent.

🚀 How It Works: 
1️⃣ Click the ImageSwap icon in your Chrome toolbar.
2️⃣ Use the toggle switch to enable/disable image replacement instantly. 
3️⃣ Access Settings for advanced options: whitelist management, Active URLs with per-site replacement modes, global replacement mode, and custom CSS. 
4️⃣ Navigate to any webpage—images transform automatically while maintaining their original dimensions. 

🌟 Why Choose ImageSwap? 
Whether you're building mockups, testing responsive layouts, debugging broken images, or creating wireframes, ImageSwap gives you instant visual transformation without touching a single line of code. See your designs come to life with beautiful, consistent placeholder images that respect your layout's original dimensions.

Perfect For: 
✅ Web designers testing layouts and mockups 
✅ Developers debugging image loading issues 
✅ UI/UX professionals creating wireframes 
✅ Content strategists visualizing page structures 
✅ Anyone needing placeholder images for development

🔒 Privacy: 
No data is collected or shared. All settings are stored locally in your browser using Chrome's secure storage API. The extension only connects to the free Picsum Photos CDN for placeholder images.

🛡️ Built with Manifest V3 Engineered with the latest Chrome extension standards for maximum security, performance, and reliability.

🔗 Open Source: 
GitHub: https://github.com/Grohon/image-swap 
Issues: https://github.com/Grohon/image-swap/issues