Skip to content

Latest commit

 

History

105 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PicLite 图轻

PicLite 图轻:开源跨平台本地图片动图压缩工具,智能择优压缩,本地文件夹监控,强大自定义悬浮窗。自动图片格式转换,批量压缩,添加水印,上传图床。支持 Windows、macOS、Linux 与可自托管 Web 端。 帮助自媒体工作人员和开发人员提升工作效率

English · 下载桌面版 · Web 演示 · 插件开发 · 问题反馈

PicLite 工作台

主要能力

  • JPEG、PNG、WebP、GIF 导入、转换、压缩与等比例缩放
  • 默认自动比较候选格式,在尽量保持观感的前提下选择更小结果
  • 原图/结果对比、实时体积、连续画质与尺寸控制、文字水印
  • 可将输出限制在 200 KB、100 KB、50 KB 或自定义大小,按真实编码结果自动调整画质与尺寸
  • 支持一次导入整个文件夹并递归加入其中图片,大批量导入沿用低内存队列
  • 剪贴板监听、全局快捷键、文件夹监测与本地图库
  • 类 Clop 的桌面悬浮结果:复制、预览、撤销、继续缩小、切换格式,并在左下状态位反馈操作成功或失败
  • 结果数量上限、堆叠/展开两种悬浮布局、自动隐藏
  • 覆盖源文件、同目录重命名或固定目录输出,并支持定期清理
  • WebDAV、S3/R2、OSS、FTP、SFTP 图床上传
  • 可加载本地 HTML/JavaScript 或 URL 工作台插件;图库与文件夹监测也可独立启停
  • Tauri 2 + Rust 桌面端;图片默认只在本机处理

悬浮窗工作流

桌面端可通过全局快捷键、复制图片、拖放文件或“选择本地图片”唤出悬浮窗,无需先打开完整工作台。图片完成自动择优后,把鼠标移到预览图上即可复制、预览、定位文件、撤销、继续缩小、切换格式、加水印或上传图床。悬浮结果支持拖动和缩放、堆叠循环与展开布局、数量上限和自动隐藏,并可在设置中自由选择最多 6 个操作按钮。

截图

image

下载

Releases 下载:

  • Windows x64 / ARM64:.exe.msi
  • macOS Apple Silicon / Intel:.dmg
  • Linux x64 / ARM64:.AppImage.deb

macOS 构建目前为 ad-hoc 签名,首次运行可能需要在“系统设置 → 隐私与安全性”中允许打开。

Web 与 Docker

GitHub Pages 在线 Demo 是无需安装的静态版本,图片直接在浏览器本地处理,不会上传到服务器。系统托盘、全局快捷键、剪贴板持续监听和文件夹监测等系统级功能请使用桌面端。

需要局域网访问、固定域名或自己的服务入口时,可使用 GHCR 镜像部署 Docker 版本。默认服务端口为 3456

Docker Compose(推荐)

git clone https://github.com/amiaoapp/PicLite.git
cd PicLite
docker compose pull
docker compose up -d

升级、查看状态和日志:

docker compose pull
docker compose up -d --remove-orphans
docker compose ps
docker compose logs -f piclite

可在项目目录创建 .env 修改监听地址、宿主机端口或版本:

PICLITE_BIND=0.0.0.0
PICLITE_PORT=3456
PICLITE_TAG=1.5.0

如需从当前源码本地构建:

docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

Docker Run

docker run -d \
  --name piclite \
  -p 3456:3456 \
  --restart unless-stopped \
  ghcr.io/amiaoapp/piclite:latest

浏览器打开 http://服务器IP:3456。GitHub Pages 与 Docker Web 端都保留压缩工作台;受浏览器权限限制,不提供系统托盘、全局快捷键和持续文件夹监测。

反向代理时将域名转发至 http://127.0.0.1:3456。例如 Caddy:

piclite.example.com {
  reverse_proxy 127.0.0.1:3456
}

本地开发

要求 Node.js 22.13+、Rust stable,以及目标平台的 Tauri 2 系统依赖。

npm install
npm run dev
npm run desktop:dev

验证与构建:

npm test
npm run desktop:build

创建工作台插件

PicLite 插件不再用 iframe 嵌入。桌面端会读取 HTML/CSS/JavaScript,并挂载到工作台的可信插件容器;因此不会被站点的 X-Frame-Options 阻止,也支持自定义标签名称。请只安装你信任的代码。

最小插件只需一个 HTML 文件:

<!doctype html>
<meta charset="utf-8">
<main id="tool">
  <h1>我的图片工具</h1>
  <button id="ready">完成</button>
</main>
<script>
  document.querySelector("#ready").onclick = () => {
    window.PicLitePlugin.post("ready", { ok: true });
  };
</script>

打开“设置 → 插件”,可直接导入 .html.jsmanifest.json;也可填写自定义名称和 HTTPS 地址,由桌面端读取后运行。清单示例:

{
  "nameZh": "封面设计大师",
  "nameEn": "Banner Maker",
  "url": "https://example.com/plugin/"
}

完整的运行时 API、资源路径规则和发布注意事项见插件开发教程

隐私与许可证

图片压缩默认在浏览器或桌面客户端本地完成;只有主动使用图床上传时,文件才会发送到你配置的服务。

PicLite 使用 GPL-3.0-or-later。桌面自动化工作流借鉴并改编自 GPL 项目 FuzzyIdeas/Clop,PicLite 不使用 Clop 商标;详情见 THIRD_PARTY_NOTICES.md

About

PicLite 图轻 / PicLite — privacy-first image and GIF compression for Web, Windows, macOS and Linux.

Resources

Stars

613 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages