Aperture

Aperture creates personalized recommendation libraries for your Emby and Jellyfin media server users using OpenAI embeddings and pgvector similarity search.

  • AI
  • Media Applications
  • Media Servers
  • Other
  • Productivity
  • Tools & Utilities
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
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

61/100 Good

Maintained
82last commit 12 days ago
Popular
3134 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
502 GB minimum RAM
Security check
88no serious findings, 2 minor, CI, tests

Availability: platform listings confirmed today, links checked 24 days ago

GitHub stars
34
Open issues
7
Last commit
2026-11-08
Latest release
v1.0.3
License
AGPL-3.0
Activity
rising

Checked 8 days ago - source: GitHub (dgruhin-hrizn/aperture)

Resources & Compatibility

Minimum requirements: 2 GB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the vue-chartjs package first Use your package manager (the tool that adds project dependencies) to run pnpm add vue-chartjs, yarn add vue-chartjs, or npm i vue-chartjs. Without it, imports for the chart components fail and the app won't start. source
  • Register the chart pieces you want If you are using vue-chartjs v4, tell Chart.js which chart features to load by calling ChartJS.register with the parts you use, such as Bar, Title, Tooltip, Legend, and scale types. Without registering them, the chart may not draw or may be missing labels, axes, or tooltips. source
  • Docker Compose Download the docker-compose file for your platform from the README quick-start. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads