awesome-projects/browser-extension-easy-image-saver
7
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
3 commits 1 branch 0 tags 302 KiB
Find a file
Exact
Ken Ng e315b851e5 feat: Implement global mouseover listener for overlay display and hide logic
2026-01-05 10:37:16 +08:00
.gitignore feat: add icon and gitignore 2025-12-15 09:21:56 +08:00
background.js init 2025-12-15 09:03:32 +08:00
content.css init 2025-12-15 09:03:32 +08:00
content.js feat: Implement global mouseover listener for overlay display and hide logic 2026-01-05 10:37:16 +08:00
icon.png feat: add icon and gitignore 2025-12-15 09:21:56 +08:00
icon16.png feat: add icon and gitignore 2025-12-15 09:21:56 +08:00
icon48.png feat: add icon and gitignore 2025-12-15 09:21:56 +08:00
manifest.json feat: add icon and gitignore 2025-12-15 09:21:56 +08:00
options.css init 2025-12-15 09:03:32 +08:00
options.html init 2025-12-15 09:03:32 +08:00
options.js init 2025-12-15 09:03:32 +08:00
popup.html init 2025-12-15 09:03:32 +08:00
popup.js init 2025-12-15 09:03:32 +08:00
README.md init 2025-12-15 09:03:32 +08:00
reproduction.html init 2025-12-15 09:03:32 +08:00

README.md

Easy Image Saver

Easy Image Saver is a powerful and aesthetic Chrome extension that helps you download images from the web with a single click. Organize your downloads into specific subfolders or force absolute path selection using smart workarounds.

🚀 Features

  • One-Click Save: Hover over any image to see a download button.
  • Smart Overlay: unobtrusive UI that appears only when needed.
  • Multiple Locations: Pre-define save locations (e.g., "Wallpapers", "Memes") in settings and select them from a dropdown menu.
  • Premium Settings UI: A beautiful, dark-mode configuration page.
  • Absolute Path Support:
    • "Save As" Mode: Force the browser to open the native file picker for every download.
    • Symlink Support: Use Symbolic Links to map logical folders in Downloads to physical folders on external drives or your Desktop.
  • Robust Performance: Flicker-free hovering and auto-saving settings.

📦 Installation

  1. Clone or download this repository.
  2. Open Chrome and navigate to chrome://extensions/.
  3. Enable Developer mode (toggle in the top-right).
  4. Click Load unpacked.
  5. Select the folder containing this extension (browser-extension-easy-image-saver).

⚙️ Usage

Quick Save

Hover over any image. Click the Down Arrow icon to save immediately to your Default Location.

Save to Specific Folder

Hover over an image and click the Dropdown Arrow next to the save button. Select one of your configured locations.

Configuration

Click the extension icon in your browser toolbar and select Open Settings.

  • Add Location: Enter a Name (label) and a Path (subfolder inside Downloads).
  • Default Location: Choose which folder acts as the primary "Quick Save" target.
  • Show "Save As" Dialog: Enable this to manually pick the destination for every file (bypasses default locations).

💡 Pro Tip: Absolute Paths

Browsers restrict extensions to the Downloads folder for security. To save to your Desktop or External Drive automatically:

  1. Open Terminal.
  2. Create a Symlink inside your Downloads folder: 
    ln -s ~/Desktop ~/Downloads/MyDesktopLink
  3. In the extension settings, add a new location with Path: MyDesktopLink.
  4. Now, saving to "MyDesktopLink" actually saves to your Desktop!

🛠 Tech Stack

  • Manifest V3: Future-proof extension architecture.
  • Vanilla JS: Lightweight and fast, no heavy frameworks.
  • CSS Variables: Modern, easily themeable styling.

📜 License

MIT License