https://github.com/cshum/imagor-studio

Self-hosted image gallery with built-in editing and template workflows
https://github.com/cshum/imagor-studio

gallery golang photo-editing photo-gallery photos react self-hosted

Last synced: 3 months ago
JSON representation

Self-hosted image gallery with built-in editing and template workflows

• Host: GitHub
• URL: https://github.com/cshum/imagor-studio
• Owner: cshum
• License: agpl-3.0
• Created: 2024-08-25T16:17:17.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2026-03-10T10:03:32.000Z (4 months ago)
• Last Synced: 2026-03-10T17:19:07.266Z (4 months ago)
• Topics: gallery, golang, photo-editing, photo-gallery, photos, react, self-hosted
• Language: TypeScript
• Homepage: https://imagor.net
• Size: 6.27 MB
• Stars: 206
• Watchers: 1
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Imagor Studio

[![Test Status](https://github.com/cshum/imagor-studio/workflows/test/badge.svg)](https://github.com/cshum/imagor-studio/actions/workflows/test.yml)

[![Docker Hub](https://img.shields.io/badge/docker-shumc/imagor--studio-blue.svg)](https://hub.docker.com/r/shumc/imagor-studio/)

Self-hosted image gallery with built-in editing. Virtual scrolling, drag-and-drop management, multi-layer compositing, and template workflows.

- Virtual Scrolling Gallery — browse thousands of images instantly, no indexing or waiting

- Image Editing — multi-layer compositing, template workflows with instant URL generation

- Drag-and-Drop Management — upload, organize, multi-select for bulk operations

- Non-Destructive Workflow — originals untouched, all transformations via URL

  No

![Screenshots](assets/screenshots.jpg)

## Quick Start

Run with SQLite database and your image directory mounted. You can replace `~/Pictures` with the path to your preferred directory (e.g., `~/Desktop`, `~/MyPhotos`, `~/Downloads`).

```bash

docker run -p 8000:8000 --rm \

  -v $(pwd)/imagor-studio-data:/app/data \

  -v ~/Pictures:/app/gallery \

  -e DATABASE_URL="sqlite:///app/data/imagor-studio.db" \

  shumc/imagor-studio

```

Open in browser

```

http://localhost:8000

```

**What this does:**

- Mounts your Photos directory

- Creates persistent storage for the app database (SQLite)

- Redirects to admin setup process on first launch

> [!NOTE]

> Ready to dive deeper? Check out [Documentation](https://docs.studio.imagor.net/)

## Links

- **[Documentation](https://docs.studio.imagor.net/)** - Documentation including configuration, architecture, and deployment guides

- **[imagor](https://github.com/cshum/imagor)** - Fast, secure image processing server and Go library, using libvips

- **[vipsgen](https://github.com/cshum/vipsgen)** - Type-safe, comprehensive Go binding generator for libvips

- **[imagorvideo](https://github.com/cshum/imagorvideo)** - imagor video thumbnail server in Go and ffmpeg C bindings