ImgBox Pro

An image management toolkit for Obsidian

Combines image localization, renaming, and attachment cleanup into a single plugin, suitable for long-term maintenance of notes with large numbers of attachments, supporting both desktop and mobile.

Features Overview

• Image localization: download web images, handle pasted / dragged media, save base64 images
• Attachment organization: multiple save locations, link styles, YYYYMMDD-HHmmss-md5-first-6 naming, deduplication (images and non-image attachments can be controlled separately)
• Attachment cleanup: unused images, unused attachments, and unlinked attachments in the current note folder
• Image interaction (desktop): context menu, navigator highlight
• Source-note jump: image navigator or image-tab context menu supports Go to Source Note
• Single-page settings UI, with groups: Auto Trigger / Storage & Naming / Download Behavior / Image Compression / Image Cleanup / Notifications
• Settings page language automatically follows Obsidian's system language
• Cleanup Ribbon shortcut
• Full command palette access

Common Commands

Command palette entries automatically follow Obsidian's display language.

Core commands:

• Localize attachments for the current note (custom location)
• Localize attachments for the current note (Obsidian location)
• Localize attachments for all your notes (custom location)
• Clear Unused Images in Vault
• Clear Unused Attachments in Vault
• Clear Unlinked Attachments in Current Note Folder (Next to Note mode)

Notes:

• Clear Unlinked Attachments in Current Note Folder (Next to Note mode) is only available in "next to note" mode, and the folder pattern must end with ${notename}

Ribbon

The plugin provides one left cleanup Ribbon action:

• Chinese UI: 清理未使用图片
• Other UI languages: Clear unused images

It triggers:

• Clear Unused Images in Vault

Settings

The settings page uses a single-page layout, with settings grouped in the following order.

Auto Trigger

• automatic processing switch and interval
• process newly created Markdown files

Storage & Naming

• process all new attachments
• save location (follow Obsidian / next to note / root directory)
• media folder path
• move, delete, or rename media folder together
• use time + MD5 names for new images
• use time + MD5 names for new non-image attachments
• add original filename or open-file tag
• preserve link captions
• path format in tags
• do not create Obsidian attachment folder

Download Behavior

• retry count per attachment
• download unknown file types
• file size lower limit (KB)
• excluded extensions

Image Compression

• compress images toggle
• compression format (WebP / JPEG)
• image quality

Image Cleanup

• show cleanup Ribbon icon
• delete destination (Obsidian Trash / System Trash / Delete permanently)
• excluded folder list
• exclude subfolders during cleanup

Notifications

• show notifications
• command operation log modal

Supported Image Formats

Notes:

• webp, avif, and heic are recognized, saved, and cleaned correctly
• image compression currently mainly targets png

Installation

1. Open your Obsidian vault
2. Go to .obsidian/plugins/
3. Copy the plugin folder into it
4. Restart Obsidian
5. Enable ImgBox Pro in Community Plugins

Usage Notes

• Back up your vault before batch processing, batch cleanup, or large-scale link rewriting
• Clear Unused Images in Vault / Clear Unused Attachments in Vault scan the whole vault
• Clear Unlinked Attachments in Current Note Folder (Next to Note mode) only targets the current note's attachment folder

Credits

• Sergei-Korneev/obsidian-local-images-plus
• ozntel/oz-clear-unused-images-obsidian

GitHub

• nightfall-yl/obsidian-imgbox-pro

License

Using this plugin means you accept the project license terms. See:

• LICENSE