# img-webui

**Repository Path**: brt2/img-webui

## Basic Information

- **Project Name**: img-webui
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-08
- **Last Updated**: 2026-01-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图像库网站

一个基于Python Flask的高级图像库网站，支持本地和远程图像文件展示，可以展示JPG和WebP格式图像文件。

## 功能特点

- 自动扫描配置文件中指定目录及其子目录中的图像文件
- 支持JPG和WebP格式的图像显示
- 支持远程图像服务器（如Python HTTP Server）图像展示
- 响应式网格布局展示图像
- 点击图像可查看大图
- 图像懒加载和预加载优化，提升加载性能
- 简洁美观的用户界面

## 安装依赖

```bash
pip install -r requirements.txt
```

## 运行项目

```bash
python app.py
```

运行后访问 `http://localhost:5000` 查看图像库。

## 配置说明

项目使用 `config.json` 文件进行配置：

```json
{
    "image_directories": [
        ".",
        "./images"
    ],
    "remote_servers": [
        "http://localhost:8000"
    ],
    "supported_formats": [
        ".jpg",
        ".png",
        ".webp"
    ],
    "thumbnail_size": [300, 300],
    "preload_count": 10,
    "lazy_load": true
}
```

- `image_directories`: 本地图像目录列表
- `remote_servers`: 远程图像服务器URL列表
- `supported_formats`: 支持的图像格式
- `preload_count`: 预加载图像数量
- `lazy_load`: 是否启用懒加载

## 使用说明

1. 将JPG或WebP格式的图像文件放入配置文件中指定的目录中
2. （可选）配置远程图像服务器URL
3. 启动应用后，网站会自动扫描并显示所有本地和远程图像
4. 点击任意图像可查看大图

## 项目结构

```
img-fast/
├── app.py              # Flask应用主文件
├── config.json         # 配置文件
├── requirements.txt    # 项目依赖
├── README.md           # 说明文档
├── templates/          # HTML模板
│   └── index.html      # 主页模板
└── static/             # 静态资源
    ├── css/            # 样式文件
    │   └── style.css   # 主样式文件
    └── js/             # JavaScript文件
        └── script.js   # 前端交互脚本
```

## 技术栈

- 后端：Python Flask
- 前端：HTML, CSS, JavaScript
- 图像处理：Pillow库

## 注意事项

- 项目会扫描当前目录及其所有子目录中的图像文件
- 为了安全考虑，只能访问项目目录内的文件