# upcat - 图片文件夹可视化工具

一个简单易用的图片文件夹可视化工具，可以快速生成HTML预览网页并启动本地服务器。

## 功能特性

- 自动扫描指定文件夹中的所有图片文件
- 生成美观的响应式HTML预览页面
- 提供图片缩略图网格视图和点击放大预览功能
- 自动启动本地Web服务器并打开浏览器
- 支持多种图片格式：JPG、PNG、GIF、WebP、BMP、TIFF、SVG等

## 安装

使用pip安装：

```bash
pip install upcat
```

## 使用方法

### 基本使用

```bash
upcat -d /path/to/image/folder
```

这将扫描指定文件夹中的所有图片，生成HTML预览文件，并在默认端口(8000)启动Web服务器。

### 指定端口

```bash
upcat -d /path/to/image/folder -p 8080
```

这将在端口8080上启动Web服务器。

### 外网访问

服务器默认支持外网访问，启动后会显示本地访问地址和外网访问地址。在同一局域网内的其他设备可以通过外网访问地址查看图片。

**注意：** 要实现真正的互联网访问，需要确保您的电脑有公网IP或已配置端口映射。

### 命令行参数

- `-d`, `--directory`: 要可视化的图片文件夹路径（必需）
- `-p`, `--port`: 服务器端口（可选，默认8000）

## 预览效果

- 响应式网格布局，适配不同屏幕大小
- 图片卡片支持悬停效果和点击放大
- 模态框预览大图，支持ESC键关闭
- 显示文件夹信息、图片数量和生成时间

## 系统要求

- Python 3.6 或更高版本
- 无需其他第三方依赖

## 示例

```bash
# 查看当前目录下的图片
upcat -d .

# 查看指定文件夹的图片，使用端口9000
upcat -d /Users/username/Pictures -p 9000
```

## 许可证

MIT License