Image Renamer

approved

by Kuioma

This plugin has not been manually reviewed by Obsidian staff. Rename pasted images with customizable templates and frontmatter-driven naming

47 downloadsUpdated 8d agoMIT

Obsidian 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-counter frontmatter, 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

VariableDescription
{{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

  1. Open Settings → Community Plugins
  2. Search "Image Renamer"
  3. Install and enable

Manual

  1. Clone into .obsidian/plugins/image-renamer/
  2. npm install && npm run build
  3. Enable in Obsidian Community Plugins

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.