Save as Local Images

An Obsidian plugin that downloads all remote/external images in the current note and saves them locally to your vault's attachment folder. After downloading, every URL is rewritten to point to the local copy.

Works on both desktop and mobile.

Features

• One-command image download -- open the command palette and run "Save all remote images locally"
• Automatic folder structure -- images are saved under your vault's configured attachment folder, nested by the note's path (e.g. attachments/games/re/game1/)
• Supports all image formats -- markdown images ![alt](https://raw.githubusercontent.com/saltyfireball/obsidian-save-as-local-images/HEAD/url), HTML <img src="https://raw.githubusercontent.com/saltyfireball/obsidian-save-as-local-images/HEAD/url"> tags, and wiki embeds ![[url]]
• URL rewriting -- after saving, all remote URLs in the note are replaced with local file paths
• Unique filenames -- each downloaded image gets a unique ID-based filename to avoid collisions
• Content-type detection -- file extensions are determined from the HTTP response content-type header, falling back to the URL extension
• Error handling -- failed downloads are reported individually without stopping the rest
• Progress notices -- shows how many images were found, saved, and any failures (can be disabled in settings)

How to Use

1. Open a note that contains remote images
2. Open the command palette (Ctrl/Cmd + P)
3. Run Save as Local Images: Save all remote images locally
4. The plugin will:
   • Scan the note for all remote image URLs
   • Download each image
   • Save it under your attachment folder, nested by the note's location
   • Rewrite every URL in the note to point to the local file

Folder Structure

If your vault's attachment folder is set to attachments and you run the command on a note at games/re/game1.md, the images will be saved to:

attachments/games/re/game1/
  abc123def456.png
  ghi789jkl012.jpg
  ...

Supported Image Patterns

Supported file types: PNG, JPG/JPEG, GIF, BMP, SVG, WebP, ICO, TIFF, AVIF.

Installation

Obsidian Community Plugin (pending)

This plugin has been submitted for review to the Obsidian community plugin directory. Once approved, you will be able to install it directly from Settings > Community plugins > Browse by searching for "Save as Local Images".

Using BRAT

You can install this plugin right now using the BRAT plugin:

1. Install BRAT from Settings > Community plugins > Browse (search for "BRAT" by TfTHacker)

2. Open the BRAT settings

3. Under the Beta plugins section, click Add beta plugin

   

4. In the overlay, enter this plugin's repository: https://github.com/saltyfireball/obsidian-save-as-local-images (or just saltyfireball/obsidian-save-as-local-images)

   

5. Leave the version set to latest

   

6. Click Add plugin

Manual

1. Download the latest release from the Releases page
2. Copy main.js and manifest.json into your vault's .obsidian/plugins/sfb-save-as-local-images/ directory
3. Enable the plugin in Settings > Community plugins

Settings

• Show progress notices -- display notices showing how many images were found, downloaded, and any errors (enabled by default)

License

MIT