upcat 0.1.0

图片文件夹可视化工具

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

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

功能特性

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

安装

使用pip安装：

pip install upcat

使用方法

基本使用

upcat -d /path/to/image/folder

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

指定端口

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

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

外网访问

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

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

命令行参数

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

预览效果

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

系统要求

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

示例

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

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

许可证

MIT License