immich-memories 0.9.0

Turn your Immich photo library into video memory compilations with music and smart cuts

Immich Memories

Create beautiful yearly video compilations from your Immich photo library.

Immich Memories connects to your self-hosted Immich server, intelligently selects the best moments from your videos, and compiles them into shareable memory videos — perfect for year-end recaps or celebrating specific people in your life.

Full documentation: sam-dumont.github.io/immich-video-memory-generator

---

Quick Install

# One-liner (no clone needed)
uvx immich-memories --help

# Or clone and install
git clone https://github.com/sam-dumont/immich-video-memory-generator.git
cd immich-video-memory-generator
uv sync

Quick Start

# 1. Configure
mkdir -p ~/.immich-memories
cat > ~/.immich-memories/config.yaml << EOF
immich:
  url: "https://photos.example.com"
  api_key: "your-api-key-here"
EOF

# 2. Launch the UI
immich-memories ui
# Opens at http://localhost:8080

# 3. Or use the CLI
immich-memories generate --year 2024 --person "John" --output ~/Videos/john_2024.mp4

Key Features

• Immich Integration — Direct REST API connection with face recognition support
• Smart Clip Selection — Scene detection, interest scoring, duplicate filtering
• Face-Aware Cropping — Keeps faces centered when converting aspect ratios
• Hardware Acceleration — NVIDIA NVENC, Apple VideoToolbox, Intel QSV, AMD VAAPI
• AI Music Generation — ACE-Step or MusicGen with automatic mood detection
• Audio Ducking — Music lowers automatically during speech
• Web UI + CLI — 4-step wizard or headless automation
• Docker & Kubernetes — Containerized deployment with GPU support

Documentation

See the full documentation for:

• Installation options (uv, pip, Docker, Kubernetes, Terraform)
• UI Walkthrough
• CLI Reference
• Configuration
• Hardware Acceleration
• AI Music
• Guides

Development

make dev      # Install all dependencies
make check    # Run all checks (lint, format, typecheck, tests)
make ci       # Full CI pipeline
make help     # Show all available targets

See CONTRIBUTING.md for guidelines.

Built with AI

This entire codebase was written with AI (Claude) as an experiment in building complex software cleanly with AI assistance. 1,100+ tests, strict quality gates, the works. See DISCLAIMER.md for the full story.

License

MIT License — see LICENSE for details.

---

Made with ❤️ for the Immich community