Afilmory: A Modern Photo Gallery for Photographers with WebGL Viewer

Afilmory: A Modern Photo Gallery for Photographers with WebGL Viewer

Summary

Afilmory is a comprehensive, high-performance photo gallery platform designed for photographers. It offers features like automatic photo synchronization from various storage sources, a custom WebGL image viewer, and detailed EXIF metadata display. Users can choose between a zero-setup SaaS option or self-hosting for full control.

Repository Info

Updated on March 14, 2026
View on GitHub

Tags

TypeScriptPhoto GalleryPhotographyWebGLEXIFS3 StorageGitHub SyncSelf-Hosted

Click on any tag to explore related repositories

Introduction

Afilmory is an advanced, high-performance photo gallery solution tailored for photographers. It integrates modern web technologies to provide a seamless experience for showcasing your work. With features like S3/GitHub synchronization, detailed EXIF data display, interactive maps, and a custom WebGL viewer, Afilmory offers a robust platform for managing and presenting your photography. Whether you prefer a managed service or full control over your deployment, Afilmory provides flexible options to suit your needs.

Installation

Afilmory offers two primary ways to get started:

Option 1: Official SaaS (Recommended)

For the quickest setup, the official SaaS provides a zero-configuration experience.
? Get Started at afilmory.art

Option 2: Self-Hosting

For developers seeking full control, Afilmory can be self-hosted.

Docker (Recommended)
Refer to the official Docker deployment guide for detailed instructions:
https://github.com/Afilmory/docker

Manual Installation

# 1. Clone and install
git clone https://github.com/Afilmory/Afilmory.git
cd Afilmory
pnpm install

# 2. Configure
cp config.example.json config.json
cp builder.config.default.ts builder.config.ts
# Edit both files with your settings

# 3. Build manifest and thumbnails
pnpm run build:manifest

# 4. Start the application
pnpm dev

For more detailed self-hosting instructions, consult the Documentation.

Examples

Explore live galleries powered by Afilmory:

Why Use Afilmory?

Afilmory stands out with its blend of performance, features, and flexibility:

  • High-Performance WebGL Renderer: Experience smooth zoom, pan, and gesture support with a custom WebGL image viewer.
  • Multi-Storage Support: Seamlessly synchronize photos from S3-compatible storage, GitHub repositories, Eagle, or your local file system.
  • Comprehensive EXIF Display: Showcase detailed camera information, focal length, aperture, ISO, and more for each photograph.
  • Modern UI/UX: Built with Tailwind CSS and Radix UI, ensuring a responsive, accessible, and aesthetically pleasing gallery experience across all devices.
  • Incremental Sync: Efficiently manage your photo collection with smart change detection, processing only new or modified images.
  • Advanced Image Processing: Automatic conversion for HEIC/HEIF and TIFF, smart multi-size thumbnail generation, Blurhash placeholders, and full HDR image support.
  • Flexible Architecture: Developed as a monorepo using React 19, TypeScript, Vite, Hono, and Drizzle ORM, providing a robust and scalable foundation.

Links