<div align="center">
  <img src="https://git.djeex.fr/Djeex/lumeex/raw/branch/main/illustration/logo.svg" alt="Lumeex Screenshot" width="400"/>
</div>
<p/>
<div align="center">
<p>Yet another minimalist, lightweight photo gallery static site generator.</p>
</div>
</p>
<div align="center">
  <img src="https://git.djeex.fr/Djeex/lumeex/raw/branch/main/illustration/lumeex.png" alt="Lumeex Screenshot" />
</div>

Lumeex is a static site generator designed to create minimalist photo galleries that highlight your artworks over the author. It empowers users to organize and explore images using tags, with each page load presenting photos in a random order to encourage discovery of new content.

👉 __Check the online version : [Lumeex-web](https://lumeex.djeex.fr)__

The project includes two thoughtfully designed themes—one modern, one minimalistic—both crafted to keep the spotlight on your photos:

- **Modern** — [View Demo](https://modern.djeex.fr)  
- **Typewriter** — [View Demo](https://typewriter.djeex.fr)

> [!NOTE]  
> _This GitHub repository is a mirror of the primary source at [git.djeex.fr/Djeex/lumeex](https://git.djeex.fr/Djeex/lumeex). The main repository includes the full history and releases_.


## 📌 Table of Contents

- [✨ Features](#-features)
- [🐳 Docker or 🐍 Python Installation](#-docker-or--python-installation)


## ✨ Features

### Gallery (Static Website)

- Photos displayed in a new random order with every page load  
- Tag-based filtering with multi-tag support  
- Shareable URLs that retain active tag filters  
- Photo carousel on the homepage  
- Legal notice page included  
- Two customizable visual themes:
  - Modern — [Demo](https://modern.djeex.fr)  
  - Typewriter — [Demo](https://typewriter.djeex.fr)  
- Supports Google Fonts and locally hosted fonts

### No-Code Builder (WebUI Manager)

&nbsp;
<div align="center">
  <img src="https://git.djeex.fr/Djeex/lumeex/raw/branch/main/illustration/lumeex-webui.png" alt="Lumeex Screenshot" />
</div>
&nbsp;


- Configure site info, SEO, colors, fonts, and more through a simple convenient WebUI
- Add and tag your photo photos without any coding required
- Converts favicon automatically to all required formats  
- Resizes social sharing thumbnails  
- *(Optional)* Automatically resizes photos to a maximum width of 1140px  
- *(Optional)* Converts images to WebP format for optimized performance
- Build your static site in one click and get a zip archive or an output folder, ready to deploy to your preferred webserver

### Don't want a WebUI ?

- CLI process is documented

## 🐳 Docker or 🐍 Python Installation
For comprehensive documentation on installation, configuration options, customization, and demos, please visit:
https://lumeex.djeex.fr