PicUp for Typecho

A multi-backend image & attachment upload plugin for Typecho — supports 18+ cloud storage services, multiple profiles, and server-side image processing.

中文文档 · Releases · Bug Reports

Features

Feature	Description
18+ Storage Backends	Switch between cloud storage services and image hosts at any time
Multiple Profiles	Save and switch between multiple configuration sets with one click
Image Processing	Server-side compression, WebP conversion, and watermarking — toggle per profile
Extensible Architecture	Drivers and extensions are auto-discovered; drop a file into the right directory and it works
Responsive Config UI	Mobile-friendly settings panel with dark mode support
Upload Progress Toast	Real-time toast notifications showing upload status

Storage Drivers

Driver	ID	Description
Local	`local`	Follows Typecho's native logic, stores to `usr/uploads/`
Lsky Pro	`lsky`	Supports v1 / v2 API
AWS S3 / Compatible	`s3`	AWS S3, MinIO, Cloudflare R2, Alibaba Cloud OSS (S3-compatible), etc.
WebDAV	`webdav`	Standard WebDAV protocol
GitHub Repository	`github`	Stores via GitHub Contents API, supports CDN acceleration
S.EE (SM.MS)	`smms`	S.EE free image host
Alibaba Cloud OSS	`aliyunoss`	Alibaba Cloud Object Storage Service (native V1 signature)
Tencent Cloud COS	`tencentcos`	Tencent Cloud Object Storage (COS V5 signature)
Qiniu Cloud KODO	`qiniukodo`	Qiniu Cloud object storage
Upyun USS	`upyun`	Upyun cloud storage
EasyImage	`easyimage`	Self-hosted EasyImage
Cloudflare ImgBed	`cfimgbed`	Image host based on Cloudflare Workers
NodeImage	`nodeimage`	NodeImage host, authenticated via `X-API-Key`
Chevereto V4	`cheveretoV4`	Self-hosted Chevereto V4, supports albums
Imgur	`imgur`	Supports anonymous and account-based uploads
OneImg	`oneimg`	Bearer Token authentication
Telegram ImgBed	`tgimagebed`	tg-imagebed project, supports anonymous and token uploads
Zpic	`zpic`	Zpic / ImgURL Pro, supports V2/V3 API

Image Processing Extensions

Extensions live in the extensions/ directory and can be enabled or disabled independently per profile.

Extension	ID	Requires	Description
Compression	`compress`	PHP `gd`	Lossy/lossless compression for JPEG/PNG/WebP with configurable quality
WebP Conversion	`webp`	PHP `gd` + WebP support	Converts JPEG/PNG/GIF/BMP to WebP before upload
Watermark	`watermark`	PHP `gd`	Text watermark (TTF font) or image watermark with position and opacity control

Note: Extensions process files server-side before they are sent to cloud storage. The original file is never modified.

Requirements

Item	Minimum	Notes
PHP	7.4+	8.0+ recommended; `curl`, `json`, and `fileinfo` extensions required
Typecho	1.3.0+	Namespace-based version required
OpenSSL	1.1.0+	Older versions may cause TLS handshake failures with Cloudflare and similar services

Installation

Option 1 — AB-Store (Recommended)

Check PicUp on AB Store Web.

Option 2 — Manual

Download the latest ZIP from GitHub Releases / AB Store Web
Extract the archive and rename the folder to PicUp
Upload it to usr/plugins/ in your Typecho installation
Go to Admin → Console → Plugins → enable PicUp

Option 3 — Git Clone

cd /path/to/typecho/usr/plugins/
git clone https://github.com/lhl77/Typecho-Plugin-PicUp.git PicUp

Setup

1. Configure a Profile

After activating the plugin, go to Admin → Settings → PicUp.

Profiles are stored as JSON. Each top-level key is a profile name. Choose a driver with "driver" and fill in the required fields for that driver. Add a "_extensions" block to configure image processing per profile.

Example — Alibaba Cloud OSS with compression and WebP:

{
  "my-oss": {
    "driver": "aliyunoss",
    "endpoint": "oss-cn-hangzhou.aliyuncs.com",
    "bucket": "my-bucket",
    "accessKeyId": "YOUR_KEY_ID",
    "accessKeySecret": "YOUR_KEY_SECRET",
    "prefix": "images",
    "urlPrefix": "https://cdn.example.com",
    "_extensions": {
      "compress": { "enabled": true, "quality": "82" },
      "webp":     { "enabled": true, "quality": "85" },
      "watermark": { "enabled": false }
    }
  }
}

Keep your credentials private. Never commit your JSON config to a public repository.

2. Select the Active Profile

After saving, pick the profile you want to activate from the dropdown and save again. All subsequent uploads will use that profile.

Driver Reference

Local Storage

Field	Description	Example
`uploadDir`	Upload directory relative to the Typecho root	`usr/uploads`
`urlPrefix`	File URL prefix; leave blank to use the site URL automatically	`https://example.com`

Lsky Pro

Field	Description
`server`	Host URL, e.g. `https://pic.example.com`
`token`	API Token (without the `Bearer` prefix)
`strategy_id`	Storage strategy ID (optional)
`album_id`	Album ID (optional)
`api_version`	API version: `v1` or `v2`

Alibaba Cloud OSS

Field	Description	Example
`endpoint`	Region endpoint	`oss-cn-hangzhou.aliyuncs.com`
`bucket`	Bucket name	`my-bucket`
`accessKeyId`	Access Key ID
`accessKeySecret`	Access Key Secret
`prefix`	Path prefix (optional)	`images`
`urlPrefix`	Custom CDN domain (optional)	`https://cdn.example.com`

Tencent Cloud COS

Field	Description	Example
`region`	Region	`ap-guangzhou`
`bucket`	Bucket name including AppId	`my-bucket-1250000000`
`secretId`	SecretId
`secretKey`	SecretKey
`prefix`	Path prefix (optional)	`images`
`urlPrefix`	Custom domain (optional)	`https://cdn.example.com`

Qiniu Cloud KODO

Field	Description
`accessKey`	Access Key
`secretKey`	Secret Key
`bucket`	Bucket name
`zone`	Storage zone (`z0`=East China, `z1`=North China, `z2`=South China, `na0`=North America, `as0`=Southeast Asia)
`urlPrefix`	Bound custom domain (required — Qiniu does not provide free test domains)
`prefix`	Path prefix (optional)

Upyun USS

Field	Description
`service`	Service (bucket) name
`operator`	Operator account
`password`	Operator password
`urlPrefix`	Bound custom domain
`prefix`	Path prefix (optional)

GitHub Repository

Field	Description	Example
`token`	Personal Access Token with `repo` scope
`repo`	Repository (`owner/repo`)	`lhl77/images`
`branch`	Branch	`main`
`prefix`	Path prefix (optional)	`images`
`cdn`	CDN acceleration URL (optional)	`https://cdn.jsdelivr.net/gh/lhl77/images`

S3-Compatible (AWS S3 / MinIO / R2 / etc.)

Field	Description
`endpoint`	Endpoint URL
`region`	Region
`bucket`	Bucket name
`accessKey`	Access Key
`secretKey`	Secret Key
`pathStyle`	Use path-style URLs (required for MinIO)
`urlPrefix`	Custom domain (optional)
`prefix`	Path prefix (optional)

WebDAV

Field	Description	Example
`server`	WebDAV server URL	`https://dav.example.com/path`
`username`	Username
`password`	Password
`urlPrefix`	Public-facing domain for file URLs	`https://cdn.example.com`
`prefix`	Path prefix (optional)	`images`

NodeImage

Field	Description
`api_key`	API Key obtained from the NodeImage admin panel (sent as `X-API-Key` header)

Note: NodeImage uses Cloudflare as its CDN. Your server's OpenSSL must be ≥ 1.1.0, otherwise the TLS handshake will be rejected.

Chevereto V4

Field	Description
`server`	Chevereto V4 site URL, e.g. `https://pic.example.com`
`api_key`	API v1 Key from Dashboard → API in Chevereto admin
`album_id`	Album ID (optional)

Imgur

Field	Description
`client_id`	Client ID obtained from Imgur API
`access_token`	Access Token (optional) — omit for anonymous uploads
`album_hash`	Album deletehash (optional, requires `access_token`)
`cdn`	CDN replacement domain (optional) — replaces `https://i.imgur.com`

OneImg

Field	Description
`server`	Host URL, e.g. `https://img.example.com`
`token`	Bearer Token
`bucket_id`	Bucket ID (optional)
`url_prefix`	URL prefix (optional) — prepended when the host returns a relative path

Telegram ImgBed (tg-imagebed)

Field	Description
`server`	Host URL, e.g. `https://img.example.com`
`token`	Token (optional) — omit for anonymous uploads with lower rate limits

Zpic

Field	Description
`server`	Host domain, e.g. `https://zpic.example.com`
`api_version`	API version: `v3` (Bearer Token, recommended) or `v2` (uid + token, ImgURL Pro compatible)
`token`	V3 token (format `sk-xxx`) or V2 token
`uid`	UID (V2 only)
`album_id`	Album ID (optional)

Image Processing Reference

Compression

"compress": {
  "enabled": true,
  "quality": "80"
}

quality is 1–100. For JPEG/WebP it maps directly to lossy quality; for PNG it maps to compression level as (100 - quality) / 10.

WebP Conversion

"webp": {
  "enabled": true,
  "quality": "85"
}

When enabled, JPEG/PNG/GIF files are converted to .webp before upload. Requires PHP GD compiled with WebP support (--with-webp).

Watermark

"watermark": {
  "enabled": true,
  "type": "text",
  "text": "© example.com",
  "font_size": "16",
  "font_color": "#ffffff",
  "opacity": "80",
  "position": "bottom-right",
  "font_path": "",
  "image_path": "",
  "image_scale": "20"
}

Field	Description
`type`	`text` (text watermark) or `image` (image watermark)
`text`	Watermark text content
`font_size`	Font size in pixels
`font_color`	Font color in hex
`opacity`	Opacity 0–100
`position`	`top-left` / `top-right` / `bottom-left` / `bottom-right` / `center`
`font_path`	Path to a TTF font file (required for CJK characters)
`image_path`	Path to the watermark image (`type=image` only)
`image_scale`	Watermark image width as a percentage of the original image width

The plugin bundles Noto Sans for text watermarks. For CJK text watermarks, provide a TTF/OTF font containing CJK characters (e.g. NotoSansCJK-Regular.ttc) or rely on a system font that the plugin auto-detects.

Directory Structure

PicUp/
├── Plugin.php        # Main plugin file
├── README.md
├── vendor/           # Storage drivers
└── extensions/       # Image processing extensions

Contributing

Issues and pull requests are welcome on GitHub.

Name		Name	Last commit message	Last commit date
assets		assets
extensions		extensions
vendor		vendor
Action.php		Action.php
LICENSE		LICENSE
Plugin.php		Plugin.php
README.md		README.md
README_CN.md		README_CN.md
README_SEE.md		README_SEE.md

Navigation Menu

Repository files navigation

PicUp for Typecho

Features

Storage Drivers

Image Processing Extensions

Requirements

Installation

Option 1 — AB-Store (Recommended)

Option 2 — Manual

Option 3 — Git Clone

Setup

1. Configure a Profile

2. Select the Active Profile

Driver Reference

Image Processing Reference

Compression

WebP Conversion

Watermark

Directory Structure

Contributing

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

PicUp for Typecho

Features

Storage Drivers

Image Processing Extensions

Requirements

Installation

Option 1 — AB-Store (Recommended)

Option 2 — Manual

Option 3 — Git Clone

Setup

1. Configure a Profile

2. Select the Active Profile

Driver Reference

Image Processing Reference

Compression

WebP Conversion

Watermark

Directory Structure

Contributing

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages