ObSweet

An Obsidian plugin for image management and workflow enhancements.

中文文档请见 README.zh.md

---

Features

Paste Image Routing

When you paste an image, ObSweet automatically saves it to a configurable path relative to the current note instead of the vault root. The default template is .img/{filename}, so images pasted into My Note.md go to .img/My Note/.

The inserted reference uses standard Markdown syntax: ![img](./img/My Note/timestamp.png).

Note Rename Sync

When you rename a note, ObSweet detects image folders whose name matches the old note name and prompts you to rename them to match the new name. It also updates all ![[]] and ![]() image references in the note to reflect the new paths.

Organize Note Images

Right-click any note in the file explorer and choose Organize note images to move all images referenced by that note into the configured path template. If an image is referenced by multiple notes, you can choose to skip, copy, or move it.

Folder Cleanup Menu

Right-click any folder and choose Clean up folder to open a cleanup dialog. It shows:

• Orphan images — image files inside the folder with no references in any .md file
• Empty folders — subfolders that contain no files (including those that would become empty after orphan removal)

Each category has a View details link that opens a tree view where you can deselect individual items. Confirmed items are moved to the unified trash.

Orphan Image Cleanup (Global)

Run the Clean up orphan images command from the command palette to scan the entire vault and move all unreferenced images to trash.

---

Trash

All cleanup operations move files to /_trash/{timestamp_ms}/{original_path} at the vault root, preserving the full original path for easy recovery. For example, /a/b/photo.png becomes /_trash/1746000000000/a/b/photo.png.

On startup, ObSweet automatically sends trash batches older than the configured retention period to the system trash.

---

Settings

Setting	Default	Description
Image path template	./img/{filename}	Path template for pasted images. {filename} is replaced with the note's base name.
Auto-route pasted images	On	Enable/disable paste routing.
Sync folders on note rename	On	Enable/disable rename sync.
Trash root folder	_trash	Name of the vault-root folder used as trash.
Trash retention days	3	Trash batches older than this many days are sent to the system trash on startup.

---

Installation

1. Download main.js and manifest.json from the latest release.
2. Copy them to <vault>/.obsidian/plugins/obsweet/.
3. Enable the plugin in Settings → Community plugins.

---

License

MIT