Documentation

Everyday guides for both products live right here. The deeper Server documentation — installation, configuration, architecture — lives with the source on GitHub, versioned with the code you're actually running.

Pictaria Server

The Server guide explains every tab of the dashboard for day-to-day use — Insights, Enrich, Curate, Albums, and the rest — no terminal required. Jump straight to a section:

Insights Timeline, people, places, records — every number clickable
Enrich & Curate AI descriptions, then picking the keepers
Albums Rule-based Immich albums that maintain themselves
Frame stats & Remote What the frames have shown; control them from your phone
Settings Devices, locations, voice, backups — all from the browser

Running it yourself? The technical docs, versioned with the source:

README What it is, quickstart, and the tour
Getting started From zero to a running container
Configuration reference Every environment variable and setting
Enrich & Curate AI providers, taxonomy, review workflow
Insights How the sweep works and what it computes
Backups Protecting your Pictaria data
Architecture For the curious and the contributing

Pictaria Frame

The Frame guide covers first-run setup and every setting, in the order the app presents them. Jump straight to a section:

First-run setup Immich connection → name the frame → pick photos → optional server
Upgrades & Settings PIN What the one-time unlocks add; guest-proofing the frame
Albums & content source Which photos show, and how often the frame re-reads them
Slideshow & display Interval, clock, overlays, brightness, night dimming, backgrounds
Voice, weather & the Server connection Wake word, spoken vs on-screen answers, weather location
Troubleshooting Connection errors, missing new photos, dark screens, voice

Quickstart

The Server, in one block.

services:
  pictaria:
    image: ghcr.io/pictaria-ai/pictaria-server:latest
    restart: unless-stopped
    ports:
      - "4080:4080"
    environment:
      IMMICH_BASE_URL: ${IMMICH_BASE_URL}   # your Immich URL
      IMMICH_API_KEY: ${IMMICH_API_KEY}     # an Immich API key
      APP_PASSWORD: ${APP_PASSWORD}         # protects the web UI
    volumes:
      - ./data:/data

Everything else — AI providers, voice, weather, backups — is configured from the web UI at http://your-server:4080.