# tinify

**Repository Path**: wscfan/tinify

## Basic Information

- **Project Name**: tinify
- **Description**: 命令行图片压缩工具，调用 Tinify API 压缩图片，并自动备份原图。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-23
- **Last Updated**: 2026-07-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tinify

命令行图片压缩工具，调用 [Tinify (TinyPNG)](https://tinify.com/) API 压缩图片，并自动备份原图。

## 安装

```bash
cd /Users/ws/ZCodeProject/tinify
npm install
npm link   # 注册全局命令 tinify
```

## 获取 API Key

前往 https://tinypng.com/developers ，用邮箱注册即可获得 API Key（每月免费 500 次压缩额度）。

## 使用

```bash
tinify <图片文件>
```

示例：

```bash
$ tinify photo.png
正在压缩 photo.png ...
✓ photo.png: 1.2 MB → 412.3 KB (减少 66.2%)
  原图备份: photo_origin.png
```

压缩成功后：
- 原图重命名为 `photo_origin.png`（备份）
- 压缩后的图片保存为原始文件名 `photo.png`

### 支持格式

`.jpg` `.jpeg` `.png` `.webp`

## API Key 配置

按以下优先级读取：

1. 环境变量 `TINIFY_API_KEY`
2. 配置文件 `~/.config/tinify/key`

首次运行时若两者都没有，会交互式提示输入并保存到配置文件（权限 600）。

设置环境变量：

```bash
export TINIFY_API_KEY=你的key
```

## 帮助

```bash
tinify --help
```