# 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

| 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

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