immich

Upload local images and videos to an Immich server via REST API.

11|4|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/zrong/skills --skill immich-zrong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: immich
Source: https://github.com/zrong/skills/tree/main/immich
Command: npx skills add https://github.com/zrong/skills --skill immich-zrong

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the friction of manually uploading and organizing local media files into a self-hosted Immich server, ensuring your photo library stays synchronized and well-described.

Core Features & Use Cases

  • Automated Uploads: Batch upload images and videos from local directories to your Immich instance.
  • Metadata Preservation: Automatically syncs video descriptions, tags, and source information from sidecar files.
  • Use Case: After downloading a batch of videos from social media using the video-downloader skill, use this tool to instantly upload them to your Immich server, add them to a specific album, and preserve all original metadata.

Quick Start

Use the immich skill to upload all mp4 files from my Downloads folder to the default album.

Frequently Asked Questions about immich

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch upload local images and videos to an Immich server?

Batch upload local images and videos to an Immich server by using automated scripts that process directories and send files via the REST API. This allows you to select a local folder and automatically transfer all media files to your self-hosted instance.

Can I sync video descriptions and tags from sidecar files during an Immich upload?

Yes, you can sync video descriptions and tags from sidecar files during an Immich upload. The process automatically injects sidecar-based descriptions and patches asset metadata to ensure your self-hosted library remains well-described and synchronized.

Do I need an API key to automate photo management and upload files to Immich?

Yes, you need an active Immich API key and server configuration to automate photo management and upload files. These credentials are required to perform authenticated asset creation and patching via the REST API.

What is the best way to organize downloaded social media videos into Immich albums?

The best way to organize downloaded social media videos into Immich albums is to use an automated upload script that assigns media to specific albums while preserving original metadata. This ensures your self-hosted library stays synchronized and well-described without manual file management.

How does automated media backup handle album assignments for self-hosted photo libraries?

Automated media backup handles album assignments for self-hosted photo libraries by processing batch files through the REST API and explicitly mapping uploaded assets to designated albums. This ensures organized library management without manual intervention.