README file from
GithubObsidian Image Renamer
Rename pasted images instantly with customizable templates. Zero flicker — the old filename never appears in your note.
Features
- Instant paste rename — intercepts paste events, saves images with your template name before Obsidian inserts the link
- Drag-drop rename — auto-rename images dragged from Finder
- Customizable templates —
{{date}},{{time}},{{counter}},{{original}},{{filename}}, and frontmatter variables - Auto counter — sequential numbering per note via
image-counterfrontmatter, auto-decrements on delete - Batch organize — rename images in current note or entire vault
- Unreferenced images — find and clean up orphaned images
- Bilingual UI — English and Chinese, switchable in settings
Template Variables
| Variable | Description |
|---|---|
{{date}} |
Formatted date (configurable) |
{{time}} |
Formatted time |
{{datetime}} |
Date + time |
{{counter}} |
Auto-increment per note |
{{original}} |
Original filename (falls back to timestamp) |
{{filename}} |
Active note name |
{{any_frontmatter_key}} |
Value from frontmatter |
Default template: {{original}}
You can set per-note image folder via image-folder in frontmatter.
Commands
- Organize images in current note
- Organize images in all notes
- Find unreferenced images
Language
Default: English. Switch to Chinese in plugin settings (语言设置 → 界面语言 → 中文).
Installation
From Obsidian Community Plugins
- Open Settings → Community Plugins
- Search "Image Renamer"
- Install and enable
Manual
- Clone into
.obsidian/plugins/image-renamer/ npm install && npm run build- Enable in Obsidian Community Plugins