skills.rest
greenheadHQ
greenheadHQCOMMUNITY
Explore all skills by this author →
GitHub

viewing-immich-photo

Validates container-to-host Immich photo paths and opens images in a viewer on macOS/NixOS.

4|Updated Dec 21, 2025
Search Tags:#macos#ssh#nixos#path-validation#immich#image-viewing
One-click install
npx skills add https://github.com/greenheadHQ/nixos-config --skill viewing-immich-photo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: viewing-immich-photo
Source: https://github.com/greenheadHQ/nixos-config/tree/main/.claude/skills/viewing-immich-photo
Command: npx skills add https://github.com/greenheadHQ/nixos-config --skill viewing-immich-photo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Immich stores photos in a container-based setup; this skill helps you verify and view Immich photos by validating host paths and safely accessing images on macOS and NixOS.

Core Features & Use Cases

  • Path validation: ensures requested paths stay within /mnt/data/immich/photos or /var/lib/docker-data/immich/upload-cache and rejects traversal attempts.
  • Cross-platform viewing: supports macOS via SSH to a remote host and local NixOS access for direct viewing.
  • Image display workflow: converts container paths to host paths and opens images with your preferred viewer.
  • Use Case: When you need to confirm an Immich photo from a container-based library, quickly verify the path and view it on the host.

Quick Start

Ask the AI to view a specific Immich photo path by providing a host path such as '/mnt/data/immich/photos/library/UUID/2023/05/01/photo.jpg'.

Frequently Asked Questions about viewing-immich-photo

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

FAQPage Schema
How do I view Immich photos stored in a Docker container from a macOS host?▼

To view Immich photos from a macOS host, you can use an SSH-based retrieval workflow that connects to the remote host, converts the internal container paths to host paths, and opens the image with your preferred viewer.

How does path validation work when accessing an Immich photo library?▼

Path validation ensures requested file paths remain strictly within designated Immich directories like /mnt/data/immich/photos, actively rejecting any directory traversal attempts to prevent unauthorized file access outside the library.

Can I directly view Immich images locally on NixOS without SSH?▼

Yes, you can directly view Immich images on NixOS using local access. The system bypasses SSH requirements for NixOS, converting container paths to local host paths and opening them directly with an image viewer.

What is the process to convert container paths to host paths for Immich?▼

Converting container paths to host paths involves validating the requested file location and translating the internal Docker container directory structure into the corresponding host filesystem path before opening the image.

Does this Immich photo viewing method work across both macOS and NixOS?▼

Yes, cross-platform viewing is supported. It handles macOS by using SSH to retrieve images from a remote host, while providing direct local filesystem access for viewing images on NixOS.

Related Skills

Explore More Software Engineering Skills→
greenheadHQgreenheadHQ
4

managing-ssh

Configure SSH keys, ssh-agent loading, Tailscale VPN access and mosh sessions on macOS/NixOS.

Community
Advanced
zrongzrong
11

immich

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

Community
Advanced
L3DigitalNetL3DigitalNet
6

immich

Administer Immich Docker containers, logs, updates, and troubleshooting.

Official
Advanced
AstorYHAstorYH
15

docker-container-deploy

Deploy Docker containers to remote hosts via SSH with port mappings.

Community
Intermediate