About Tenrankai

Tenrankai (展覧会) is Japanese for "exhibition" or "gallery show," perfectly capturing the essence of this project as a platform for displaying photographic collections.

Born from the philosophy that content management should be as simple as organizing files in folders, Tenrankai is a gallery, CMS, and blog platform that relies on nothing more than your filesystem. Simply drop files in, or even use SyncThing to keep your gallery or website up to date.

Built with Rust for exceptional performance, Tenrankai delivers a fast, flexible, and feature-rich experience without the complexity of traditional database-driven systems.

Philosophy

Tenrankai is built on several core principles:

  • Simplicity First: No database, no complex setup. Just files and folders. If you can organize files, you can run Tenrankai.
  • Performance Always: Every feature is implemented with speed in mind, from concurrent image processing to intelligent caching strategies.
  • Photographer Friendly: Preserves metadata, color profiles, and image quality while providing tools photographers actually need.
  • Developer Experience: Clear configuration, extensive documentation, and a modular architecture that's easy to understand and extend.
  • Production Ready: Built for real-world use with proper error handling, logging, and security features.

Technical Excellence

Tenrankai leverages cutting-edge technologies:

  • Rust & Axum: A blazing-fast async web framework that ensures excellent performance and memory safety.
  • Smart Caching: Multi-level caching with automatic refresh and persistence across restarts.
  • Image Processing: Concurrent processing with support for JPEG, WebP, and automatic format negotiation.
  • Color Management: Full ICC profile support preserving Display P3, Adobe RGB, and other color spaces.
  • Responsive Design: Mobile-first approach with automatic image sizing for different devices.

Key Features

Multiple Galleries

Run multiple independent galleries with unique configurations, URLs, and content.

Automatic Processing

Images are automatically resized, optimized, and cached for fast delivery.

Markdown Support

Add descriptions to folders and captions to images using simple markdown files.

Blog System

Built-in markdown-based blog with TOML frontmatter and automatic refresh.

Open Source

Tenrankai is proudly open source under the Apache 2.0 license. We welcome contributions, bug reports, and feature requests from the community.

Visit our GitHub repository to get involved!