Harang Immich

Harang Immich is an Obsidian plugin that lets you browse, insert, and store note images in your own Immich server instead of inside the Obsidian vault.

Contents

• Prerequisites
• Installation
  • Method 1 — Install from within the app
  • Method 2 — Clone the Git repository
  • Next steps
• Usage
  • Profiles
  • The four core features
  • The link syntax
  • Keeping Immich in sync when you delete images
• Architecture
  • Overview
  • Multiple profiles and ImmichClient instances
  • ImmichClient and mobile compatibility
  • Rendering the custom link syntax
  • Tracking asset lifecycle
  • Settings, profiles, and secrets
  • Internationalization
• Troubleshooting & FAQ
  • “Please set the Immich server URL and API key in settings first.”
  • “Failed to fetch image list”, “Failed to load thumbnail”, “Failed to load original image” (with an HTTP status code)
  • “Upload failed” / “Upload response is missing an asset id”
  • An image shows a broken/error placeholder in the note
  • An image shows a “profile not found” error
  • An image doesn’t render as an image at all
  • Cache keeps growing / I want to free up space
  • Images fail to load only on mobile
  • Deleting a note doesn’t ask what to do with its images