- Overview
- Scorecard
- Updates10
An Obsidian plugin that lets you browse, insert, and store note images in your own Immich server instead of inside the vault.
📖 Full documentation (English/Korean): https://search5.github.io/harang-immich/
Features
- Multiple profiles — connect to more than one Immich server, each with its own name, server address, API key, and album. Each device picks its own active profile, so desktop and mobile never clash even when pointed at the same server.
- Insert an image from Immich — run the "Insert Immich image" command to open a gallery of thumbnails from your active profile's server (optionally scoped to one album) and insert the picked photo at the cursor.
- Editing-mode preview — inserted images render inline while editing (Live Preview); moving the cursor onto the link reveals the raw syntax so you can edit it.
- Reading-mode preview — the same links render as images in Reading view.
- Paste/drag to upload — pasting an image from the clipboard or dragging one in from outside Obsidian uploads it to Immich automatically and inserts the resulting link.
Deleting a link, editing it away, deleting the whole note, or renaming it prompts you to move the now-unreferenced Immich asset to trash, delete it permanently, or leave it alone.
Requirements
- Obsidian 1.13.4 or later (desktop and mobile)
- A running Immich server reachable from your device
- An Immich API key (Immich → account settings → API Keys)
Harang Immich never needs an Immich album to be shared publicly — it talks to your server directly using the API key you provide. See the prerequisites guide for details.
Installation
From within Obsidian: Settings → Community plugins → Browse → search for
Harang Immich → Install → Enable.
From source:
cd /path/to/your/vault/.obsidian/plugins
git clone https://github.com/search5/harang-immich.git
cd harang-immich
npm install
npm run build
Then enable Harang Immich under Settings → Community plugins. See the full
installation guide
for more detail.
Usage
After enabling the plugin, open Settings → Harang Immich to add a profile (server address, API key, and optionally an album) — add more profiles if you use more than one Immich server. See the usage guide for details on the link syntax, settings, and cache management, or the architecture guide for an overview of how the plugin works internally.
Running into trouble? Check the troubleshooting guide.