This plugin allows users to easily insert images from their self-hosted Immich instance into their Obsidian notes.
obsidian
immich album public. This issue will only impact you if your immich instance is publicly accessible.
- View all images from a single shared album within Immich.
- One-click insertion of one or many images into your vault.
This assumes you have a working version of immich hosted. It does not necessarily need to be remotely accessible. This decision is left up to the reader.
Immich
- Create an album on Immich. I suggest naming this 'obsidian'. This will contain all images that you want to use in obsidian moving forward.
- Visit the album in the Immich WebUI. Take note of the UUID:
https://your-immich-url.com/albums/{UUID}
. - Turn on link sharing for this album. Use the following settings:
- Require password: No.
- Show metadata: Yes.
- Allow public user to download: Yes.
- Allow public user to upload: No.
- Expire after: Never.
- Copy the share URL. Take note of the key:
https://your-immich-url.com/share/{{KEY}}
- Finally, generate and copy down your API key:
https://your-immich-url.com/user-settings?isOpen=api-keys
Obsidian
- Install the plugin.
- Fill in the following settings:
- Immich URL: full url to your Immich instance. Do not include the trailing
/
. - Immich API key: the key you generated in step 5.
- Immich Album ID: the UUID you obtained in step 2.
- Immich Album Share Key: the Key you obtained in step 4.
- Immich URL: full url to your Immich instance. Do not include the trailing
- Open the command palette in Obsidian (
ctrl/cmd + p
or swipe down on mobile). - Search
Immich
. - Select
Immich: Insert from Immich
and click on the image(s) you want to include in your note.