Image Auto Upload Pro

Image Auto Upload Pro Plugin is an Obsidian plugin for uploading images through PicGo, PicList, or PicGo-Core and replacing image links in your notes with the uploaded image-host URLs.

The plugin id is image-auto-upload-pro, so it can be installed and published as a standalone plugin without conflicting with the original obsidian-image-auto-upload-plugin.

Features

• Upload pasted image files automatically.
• Upload dropped image files.
• Upload all local images in the active Markdown file.
• Select local image files from the native file picker and upload them.
• Process Markdown network images pasted into Obsidian, for example ![image](https://example.com/image.png).
• Process Web Clipper Markdown files automatically when files are created or modified in a configured folder such as Clippings.
• Download network images to a temporary vault folder, upload them to the image host, replace the Markdown links, and delete the temporary files after a successful replacement.
• Skip image-host URLs that were already relayed by this plugin to avoid repeated upload loops.
• Configure a network-image domain blacklist.
• Support PicGo/PicList app server mode and PicGo-Core.
• Support PicList upload URL parameters such as picbed and configName.

Requirements

• Obsidian desktop.
• A working PicGo, PicList, or PicGo-Core setup.
• An image host configured inside PicGo/PicList/PicGo-Core.

For PicGo or PicList app mode, enable the local server and use an upload URL such as:

http://127.0.0.1:36677/upload

For PicList 2.5.3 or later, you can choose a picbed and config name with URL parameters:

http://127.0.0.1:36677/upload?picbed=smms&configName=piclist

Installation

Manual Installation

1. Download or build main.js and manifest.json.
2. Create this folder in your vault:

.obsidian/plugins/image-auto-upload-pro/

3. Copy main.js and manifest.json into that folder.
4. Restart Obsidian or reload community plugins.
5. Enable Image Auto Upload Pro Plugin in Obsidian settings.

Local Build

pnpm install
pnpm run build

Then copy the generated files into your vault plugin folder:

cp main.js manifest.json /path/to/your/vault/.obsidian/plugins/image-auto-upload-pro/

Configuration

Open Obsidian settings and configure Image Auto Upload Pro Plugin.

Important settings:

• Auto pasted upload: enable automatic upload when pasting image files or Markdown network images.
• Default uploader: choose PicGo app, PicList app, or PicGo-Core.
• PicGo server: local upload endpoint, usually http://127.0.0.1:36677/upload.
• Remote server mode: upload file data to a remote PicList server. Network image processing is disabled in this mode.
• Work on network: enable uploading Markdown network images.
• Network Domain Black List: comma-separated domains that should not be uploaded.
• Clipper image download folder: vault-relative temporary folder for downloaded Web Clipper images. Default: image-auto-upload-temp.
• Auto process Web Clipper notes: watch the configured folder and process newly created or modified Markdown files.
• Web Clipper watch folder: vault-relative folder to watch. Default: Clippings.
• Web Clipper process delay: debounce delay in milliseconds. Default: 1500.
• Upload when clipboard has image and text together: decide whether mixed clipboard content should still upload the image file.
• Delete source file after you upload file: delete local source files after successful upload when supported by the current workflow.

Usage

Paste Image Files

Copy an image file or screenshot and paste it into an Obsidian Markdown file. The plugin uploads the image and inserts the uploaded Markdown image link.

Paste Markdown Network Images

Enable Auto pasted upload and Work on network, then paste Markdown like:

![example](https://example.com/image.png)

The plugin inserts the pasted Markdown first, downloads the remote image, uploads it through PicGo/PicList/PicGo-Core, replaces the original URL, and removes the temporary downloaded file.

Process Web Clipper Notes

Set Web Clipper watch folder to the folder where Obsidian Web Clipper writes Markdown files. The default is:

Clippings

When a Markdown file is created or modified in that folder, the plugin automatically processes network images in the note.

Commands

Open the Obsidian command palette and run:

• Image Auto Upload Pro: Upload all images
• Image Auto Upload Pro: Download all images
• Image Auto Upload Pro: Upload local images from file picker
• Image Auto Upload Pro: Download, upload, and cleanup clipped network images

Per-Note Frontmatter

Use frontmatter to override automatic paste upload for a single note:

---
image-auto-upload-pro: true
---

Set it to false to disable automatic upload in that note.

Development

Run tests:

pnpm test

Run TypeScript checks:

pnpm run typecheck

Build the plugin:

pnpm run build

Publishing Checklist

To publish this plugin to the Obsidian community plugin marketplace:

1. Keep manifest.json id as image-auto-upload-pro.
2. Create a public GitHub repository.
3. Add README.md, LICENSE, manifest.json, and source files.
4. Build the plugin.
5. Create a GitHub release whose tag matches manifest.json version.
6. Attach main.js, manifest.json, and styles.css if the plugin uses one.
7. Submit the plugin through the official Obsidian Community Directory.

Notes

• PicGo/PicList must be running when using app server mode.
• Network image upload requires Work on network and is not available when Remote server mode is enabled.
• The plugin remembers recently uploaded image-host URLs so that Web Clipper auto-processing does not upload the same replacement URL again.

Credits

This project is based on obsidian-image-auto-upload-plugin and keeps compatibility with PicGo/PicList workflows while adding the Pro features for local file selection, Markdown network image relay, and Web Clipper automation.

Thanks to:

• obsidian-imgur-plugin
• PicGo
• PicList