Img Cleanup

Obsidian plugin that detects images and attachments that became unlinked from a note while you edit it, and offers to send them to the trash — respecting Obsidian's trash settings and keeping a trace log of every action.

Features

• Live detection: listens for changes in the vault's .md files (with a 1.5 s debounce so it doesn't interrupt while you type) and compares attachments referenced before/after.
• Supported formats: ![](path), ![[file]], [[file]] and Markdown links. External URLs are ignored.
• Watched folders only: defaults to .img/ (configurable in Settings); any attachment outside those folders is ignored.
• Backlinks: if another note still references the file, it is not offered for deletion.
• Batch modal: a single window lists the unlinked files with a checkbox per file and Delete / Keep buttons.
• "Don't ask again": persists the last action as a permanent policy (always delete / always keep). Resettable from Settings.
• Obsidian's trash: uses fileManager.trashFile() — never permanently deletes against the user's trash configuration.
• Trace log: JSONL with date, file, source note, destination and action. Rotated with a 1000-entry cap. History viewable from a modal (open file / clear).

Installation

1. Create the folder .obsidian/plugins/img-cleanup/ inside your vault.
2. Copy manifest.json and main.js into it (already compiled in this repo).
3. Restart Obsidian → Settings → Community plugins → enable Img Cleanup.

Configuration (Settings → Img Cleanup)

The log lives in .obsidian/plugins/img-cleanup/data/appendix-log.jsonl.

Development

Requires Node.js 18+.

npm install        # dependencies
npm run build      # typecheck + production bundle → main.js
npm run dev        # watch mode (auto rebuild)

Structure

manifest.json
versions.json
esbuild.config.mjs
tsconfig.json
src/
  main.ts            # entry: events, policy, backlinks, trash
  settings.ts        # PluginSettingTab
  diff.ts            # reference parser + debounce + snapshot
  log.ts             # JSONL log + rotation
  modal-delete.ts    # batch confirmation modal
  modal-history.ts   # history modal
docs/
  documento_de_lineamientos_para_el_desarrollo_del_plugin_de_obsidian.md

Out of scope

• Scanning for orphan files (attachments not referenced by any note).
• Markdown notes linked to each other (attachments/images only).
• Canvas.

License

MIT