Immich icon

Immich

Interact with Immich, a self-hosted photo and video management solution

Overview

This node interacts with the Immich API to perform metadata searches for assets such as photos and videos. It allows users to specify various search criteria like city, country, camera make and model, state or province, and date ranges for when the assets were taken. This node is useful for filtering and retrieving specific media assets based on detailed metadata, which can be beneficial for organizing, managing, or analyzing large collections of media files.

Use Case Examples

  1. Search for all photos taken in a specific city and country within a certain date range.
  2. Find assets captured with a particular camera make and model.
  3. Retrieve media files taken before or after a specified date.

Properties

Name Meaning
Search Fields Collection of search criteria to filter assets by metadata such as city, country, camera make, model, state, and date ranges.
Request Options Settings to control request behavior such as batching, SSL certificate validation, proxy usage, and timeout duration.

Output

JSON

  • results - Array of assets matching the search criteria, including their metadata.

Dependencies

  • Requires an API key credential for authenticating with the Immich API.

Troubleshooting

  • Ensure that the API base URL and credentials are correctly configured to avoid authentication errors.
  • If SSL certificate validation fails and the 'Ignore SSL Issues' option is not enabled, requests may be blocked; enable this option cautiously if needed.
  • Batching settings should be configured properly to avoid overwhelming the server or hitting rate limits.
  • Timeouts may occur if the server is slow to respond; increase the timeout setting if necessary.

Links

  • Immich API Documentation - Official documentation for the Immich API, useful for understanding available endpoints and parameters.

Discussion