vitaImmich

Minimal proof-of-concept Immich client for the PS Vita. It connects to your Immich server and shows your photo library as a scrollable chronological grid (newest first), with a full-screen viewer.

Requirements

• A PS Vita with HENkaku/h-encore and VitaShell
• An Immich server reachable from the Vita's Wi-Fi (recent Immich version — it uses POST /api/search/random and GET /api/assets/{id}/thumbnail)
• An Immich API key (web UI → Account Settings → API Keys)

Building

Needs VitaSDK with the libvita2d, curl, openssl, zstd, zlib, libpng, libjpeg-turbo and freetype packages installed (via vdpm).

export VITASDK=$HOME/vitasdk
export PATH=$VITASDK/bin:$PATH
cmake -B build -S .
cmake --build build

This produces build/vitaImmich.vpk.

Installing & configuring

1. Copy vitaImmich.vpk to the Vita and install it with VitaShell.

2. Launch it once — it creates ux0:data/vitaimmich/config.txt.

3. Edit that file (VitaShell → SELECT for FTP makes this easy):

   server=http://192.168.1.100:2283
   apikey=your-immich-api-key
   

   If your server sits behind a public domain (reverse proxy) and your router does not support NAT loopback, add the server's LAN IP so the domain is pinned to it while on your home network:

   server=https://immich.example.com
   apikey=your-immich-api-key
   serverip=192.168.1.100
   

   This keeps the Host header and TLS SNI on the domain (so the reverse proxy still routes correctly) but connects to the LAN IP directly.

4. Relaunch the app.

Controls

Grid view:

Button	Action
D-pad	Move selection (hold to repeat)
L / R	Jump two rows up / down
X	Open photo full screen
START	Exit

Full-screen view:

Button	Action
Left / Right	Previous / next photo
X	Retry a failed photo
O	Back to grid
START	Exit

More of the library is fetched automatically (100 photos at a time, newest first) as you scroll toward the end. Errors are shown on screen and logged to ux0:data/vitaimmich/log.txt.

PoC limitations

• TLS certificate verification is disabled (no CA bundle is shipped), so prefer plain HTTP on a trusted LAN or treat HTTPS as unverified.
• Thumbnails stream in on a background thread (one at a time over a keep-alive connection); cells show a grey placeholder until loaded.
• Caps at 1000 photos per launch; no albums, search, video or upload.