Aperture
Aperture creates personalized recommendation libraries for your Emby and Jellyfin media server users using OpenAI embeddings and pgvector similarity search.
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
Variants
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