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.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party 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.