# Aperture

Aperture is a self-hosted ai app. Aperture creates personalized recommendation libraries for your Emby and Jellyfin media server users using OpenAI embeddings and pgvector similarity search. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2611/aperture

## Description

Aperture creates personalized recommendation libraries for your Emby and Jellyfin media server users using OpenAI embeddings and pgvector similarity search. Recommendations appear as virtual libraries in your media server's home screen, with support for both movies and TV series.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

61/100 (Good), based on 5 of 5 factors.
- Maintained: 82 (last commit 12 days ago)
- Popular: 31 (34 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)
- Security check: 88 (no serious findings, 2 minor, CI, tests)

## Links

- GitHub: https://github.com/dgruhin-hrizn/aperture
- Unraid: https://ca.unraid.net/apps/aperture-14388ni0llvq3e?q=Aperture

## Common questions

### What must I configure in the docker-compose file before starting Aperture?

Set APP_BASE_URL to the server IP address, SESSION_SECRET to a random 32+ character string, and adjust the volume paths to match your media folder locations.

### How do I handle symlinks or STRM files?

Use the File Locations step in the setup wizard to configure path mappings for symlinks or STRM files.

### Can I run Aperture without OpenAI?

Yes, the AI/LLM setup step also lets you configure Ollama or other providers.

### How do I choose which media-server users receive recommendation libraries?

Connect Aperture to your Emby or Jellyfin server, then select the users in the Users step.

### How do I migrate or restore an existing Aperture setup?

Use the optional Restore step in the setup wizard to restore from an existing backup.

---
Source: Our Local Host (https://ourlocalhost.com/app/2611/aperture), the self-hosted and open-source app directory.
