TinyImage

基于 Tinify API 的 macOS 图片压缩工具，一键在 Finder 工具栏压缩图片。

功能

Finder 工具栏一键压缩
支持图片和文件夹批量处理
支持 PNG、JPG、JPEG、WebP、AVIF 格式
灵活提示（弹窗、通知或静默）
每月免费压缩 500 张，无 5MB 限制，不够用可多申请几个API Key

快速开始

安装

下载 TinyImage.dmg
双击 DMG，将 TinyImage.app 拖到 /Applications（应用程序）文件夹

打开终端，执行以下命令去除隔离属性：

xattr -d com.apple.quarantine /Applications/TinyImage.app

按住 ⌘ Command 键，用鼠标将 TinyImage.app 拖到 Finder 工具栏

申请 API Key

前往 Tinify 官网注册，免费获得 API Key。

配置环境变量

复制下方命令，将 your_api_key_here 替换为你的真实 API Key，粘贴到终端执行：

验证是否配置成功

执行命令检查：

echo $TINIFY_IMAGE_API_KEY

如果显示你的 API Key，说明配置成功 ✅

开始使用

在 Finder 中选择要压缩的图片或文件夹
点击工具栏上的 TinyImage 图标
首次使用需要同意权限请求
等待完成（需要上传→压缩→下载）

压缩后的图片保存在 tinified 文件夹中。

提示方式配置

修改 TINIFY_SUCCESS_NOTIFICATION_TYPE 环境变量的值：

值	效果
`dialog`	弹窗提示（推荐）
`notification`	系统通知
`none`	静默（无提示）

修改方法（同样替换 API Key）：

# zsh 用户
echo 'export TINIFY_SUCCESS_NOTIFICATION_TYPE="notification"' >> ~/.zshrc && source ~/.zshrc

# bash 用户
echo 'export TINIFY_SUCCESS_NOTIFICATION_TYPE="notification"' >> ~/.bash_profile && source ~/.bash_profile

命令行使用（可选）

# 压缩单个文件
./TinyImage.sh image.jpg

# 压缩多个文件
./TinyImage.sh image1.jpg image2.png image3.webp

# 压缩整个文件夹
./TinyImage.sh /path/to/images/

右键菜单快速操作（可选）

想要右键菜单中也能使用 TinyImage？

打开「自动操作」应用
新建 → 快速操作
在流程中添加「运行 Shell 脚本」

粘贴以下代码：

open -a "/Applications/TinyImage.app" "$@"

保存，命名为 TinyImage

现在右键菜单中就会出现 TinyImage 选项。

常见问题

Q: 忘记点同意权限怎么办？

A: 打开系统设置 → 隐私与安全性 → 自动化 → 找到 TinyImage.app，勾选「访达」权限。

Q: Finder 工具栏提示"操作运行 Shell 脚本错误"？

A: 打开自动操作应用，在 Applications 中右键 TinyImage.app → 打开方式 → 自动操作，再直接保存即可。

Q: 如何修改已配置的 API Key？

A: 用编辑器打开 ~/.zshrc 或 ~/.bash_profile，找到相应行修改，保存后执行 source ~/.zshrc 或 source ~/.bash_profile 重新加载。

Q: 如何方便快捷的管理各种配置文件 A: 推荐使用 Configs，编辑保存后，环境变量自动生效

TinyImage - 基于 Tinify API 的 macOS 图片压缩工具