# TinyImage

**Repository Path**: ihongren/TinyImage

## Basic Information

- **Project Name**: TinyImage
- **Description**: macOS image compression tool based on Tinify API - compress images with one click from Finder toolbar. 基于 Tinify API 的 macOS 图片压缩工具，一键在 Finder 工具栏压缩图片。
- **Primary Language**: Shell
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-28
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# [TinyImage](https://github.com/iHongRen/TinyImage)

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

[English README](./README_EN.md)



## 功能

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



## 快速开始

### 安装

1. 下载 [TinyImage.dmg](https://github.com/iHongRen/TinyImage/releases/download/1.0/TinyImage.dmg)
2. 双击 DMG，将 `TinyImage.app` 拖到 `/Applications`（应用程序）文件夹
3. 打开终端，执行以下命令去除隔离属性：
   ```bash
   xattr -d com.apple.quarantine /Applications/TinyImage.app
   ```
4. 按住 `⌘ Command` 键，用鼠标将 `TinyImage.app` 拖到 Finder 工具栏

![](./screenshots/install.gif)



### 申请 API Key

前往 [Tinify 官网](https://tinify.com/developers) 注册，免费获得 API Key。



### 配置环境变量

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

#### 推荐方式（一条命令自动完成）

如果你使用的是 **zsh**（默认）：
```bash
echo 'export TINIFY_IMAGE_API_KEY="your_api_key_here"' >> ~/.zshrc && echo 'export TINIFY_SUCCESS_NOTIFICATION_TYPE="dialog"' >> ~/.zshrc && source ~/.zshrc
```

如果你使用的是 **bash**：
```bash
echo 'export TINIFY_IMAGE_API_KEY="your_api_key_here"' >> ~/.bash_profile && echo 'export TINIFY_SUCCESS_NOTIFICATION_TYPE="dialog"' >> ~/.bash_profile && source ~/.bash_profile
```

#### 验证是否配置成功

执行命令检查：
```bash
echo $TINIFY_IMAGE_API_KEY
```

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



### 开始使用

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

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

![](./screenshots/tinyimage.gif)



## 提示方式配置

修改 `TINIFY_SUCCESS_NOTIFICATION_TYPE` 环境变量的值：

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

修改方法（同样替换 API Key）：
```bash
# zsh 用户
echo 'export TINIFY_SUCCESS_NOTIFICATION_TYPE="notification"' >> ~/.zshrc && source ~/.zshrc

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



## 命令行使用（可选）

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

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

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



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

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

1. 打开「自动操作」应用
2. 新建 → 快速操作
3. 在流程中添加「运行 Shell 脚本」
4. 粘贴以下代码：
   ```bash
   open -a "/Applications/TinyImage.app" "$@"
   ```
5. 保存，命名为 `TinyImage`

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

![](./screenshots/quick_contextmenu.png)

![](./screenshots/auto_quick.png)

![](./screenshots/auto_guide.png)



## 常见问题
**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](https://github.com/iHongRen/configEditor)，编辑保存后，环境变量自动生效

## 支持

如果觉得好用，欢迎 [⭐ Star](https://github.com/iHongRen/TinyImage) 支持！

[💖 赞助开发者](https://ihongren.github.io/donate.html)