Sads
ea759255da
progress on download, supports pause/resume and seeking during playback. Videos are deleted after viewing.
101 lines
3.4 KiB
Markdown
101 lines
3.4 KiB
Markdown
# vitaImmich
|
|
|
|
Minimal proof-of-concept [Immich](https://immich.app/) client for the PS Vita.
|
|
It connects to your Immich server and shows your library (photos and videos)
|
|
as a scrollable chronological grid (newest first), with a full-screen viewer
|
|
and hardware-accelerated video playback.
|
|
|
|
## 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](https://vitasdk.org/) with the `libvita2d`, `curl`, `openssl`,
|
|
`zstd`, `zlib`, `libpng`, `libjpeg-turbo` and `freetype` packages installed
|
|
(via `vdpm`).
|
|
|
|
```sh
|
|
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 item full screen |
|
|
| START | Exit |
|
|
|
|
Full-screen view:
|
|
|
|
| Button | Action |
|
|
| ------------- | --------------------------------- |
|
|
| Left / Right | Previous / next item |
|
|
| X | Play video / retry a failed photo |
|
|
| O | Back to grid |
|
|
| START | Exit |
|
|
|
|
Video playback:
|
|
|
|
| Button | Action |
|
|
| ------------- | ----------------- |
|
|
| X | Pause / resume |
|
|
| Left / Right | Seek ±10 seconds |
|
|
| O | Stop and go back |
|
|
|
|
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.
|
|
- Videos are downloaded in full to `ux0:data/vitaimmich/video.mp4` before
|
|
playback (deleted afterwards), so they need free space on the memory card
|
|
and a moment to start. Playback uses the Vita's hardware decoder via
|
|
SceAvPlayer, so only MP4 (H.264/AAC) plays — Immich's transcoded
|
|
`video/playback` stream is used, which is H.264 with default server
|
|
settings.
|
|
- Caps at 1000 assets per launch; no albums, search or upload.
|