Native image
workspace

Manage your image storage, edit images, and bring links back to your documents.
Native desktop, standalone CLI, and Agent Skill with shared storage configuration.

Download desktop Download CLI

Available for macOS, Windows, and Linux

01 / THE WORKSPACEFind uploaded images and copy their links.

The native img library with image thumbnails, file names, and copy-link controls. Isolated demo data; current app UI is Chinese.

img — zsh

$ img photo.png --format markdown --copy
✓ photo.png → your storage
![photo.png](https://images.example.com/photo.png)

The GUI and CLI share an upload core.Rust CLI

macOS desktop with demo data. Terminal shows an example command.

See img in action

A 47-second tour of the library, image tools, and native CLI.

Real macOS interface with demo data. Chinese titles, English captions, music, no narration.

46.9MB

GUI package, CLI included

0.4.0 · macOS ARM64 · DMG

23.85MB

Standalone CLI archive

0.4.0 · macOS ARM64 · tar.gz

3platforms

Native desktop and standalone CLI

macOS · Windows · Linux

Measurement methods and sources

UPLOAD WORKFLOW

Desktop uploads

Manage batch uploads in the app, or upload clipboard images and screenshots with a shortcut. Links are copied when uploads complete.

Import images

Drop files, paste an image, or import a URL. In the main window, imports wait until you are ready.

img upload photo.png --provider r2

Send to your storage

Choose storage and processing options, then upload. Pause, resume, or retry when you need to.

img upload photo.png --optimize --resize 1600

Copy the links

After uploading, copy links automatically as URLs, Markdown, or HTML and paste them into your document.

img upload photo.png --format markdown --copy

The img upload queue with import area, compact toolbar, ready images, and completed records. Chinese app UI; demo data.

img settings sections for diagnostics, storage, and image processing. Chinese app UI; demo data.

GUI and CLI are separate workflows; screenshots show the native app

IMAGE TOOLS

Prepare it. Then publish.

Open one image to convert, compress, resize, or crop. Preview the actual result, then save, copy, or upload. Your original stays intact.

Explore the image tools

img 0.4 Convert & compress: an image preview, WebP parameters, actual output size, and save, copy, and upload controls. Chinese app UI. — 0.4.0 native app · Demo data · Click to enlarge

CLI & AGENT SKILL

Integrate with your workflow

The standalone CLI works with scripts, editors, and AI agents without launching the desktop app. JSON results expose uploaded URLs and failures for subsequent tasks.

The Agent Skill supports image processing, library queries, sync status, and migration previews. Uploads reuse configured storage; remote deletion and article changes require an explicit request.

Integration guide

Upload an image · JSON output

img upload ./assets/chart.png --format json --no-copy

Install the Agent Skill

npx skills add liyown/img --skill img-uploader

Install the CLI first. Local processing needs no storage setup. Uploads use existing configuration; credentials stay out of prompts.

STORAGE PROVIDERS

Use your own storage

Connect object storage, a GitHub repository, or a custom HTTP service with your existing public domain. Desktop and CLI share configuration, with provider selection per project.

Configure storage

Cloudflare R2Amazon S3阿里云 OSSGitHubCustom HTTPS3-compatible ↗

FEATURES

Library and image processing

View all features

One library for your storage

Index existing images alongside new uploads. Search, preview, copy, and download. Clearing caches keeps library records.

Standalone image tools

Convert, compress, resize, and crop. Preview actual output size, then save, copy, or upload. No storage setup needed.

Menu bar and shortcuts

Upload screenshots or clipboard images with shortcuts. macOS also has menu-bar controls and keeps uploading when the window closes.

Sync through your storage

Sync configuration, indexes, and presets through WebDAV or S3. Cached images stay local; you decide conflicts.

Choose a link format

Copy successful links automatically. Markdown, HTML, and BBCode are also available.

Migration and article repair

Copy to another host and verify before updating references. Review and back up each document; keep source images by default.

COMPARISON

Packages and features

img combines a native desktop app and standalone CLI with shared storage configuration and image processing. The comparison covers features, package sizes, and sources for evaluating each tool against your workflow.

See the full comparison and sources

macOS package sizesmacOS ARM64 · DMG · MB

img0.4.0

46.9

PicGo3.0.2

159.8

PicList3.5.0

148.6

uPicApp Store

Comparable data unavailable

—

Compressed package size, not installed size or runtime memory. img checked Sep 8, 2026; other products Sep 7.

FAQ

Common questions

Do I install the GUI and CLI separately?

No. The GUI bundles the same-version CLI and can add a terminal entry point from settings. Install just the CLI if that is all you need.

Do images pass through an img server?

Uploads go directly from your device to the storage you configure. img does not operate a shared image host. Choose your own R2, S3, OSS, GitHub, or HTTP service.

Which operating systems are supported?

The desktop app supports macOS 13+ on Apple silicon and Intel, Windows x64, and Ubuntu 24.04 / Debian 13+ x64. The standalone CLI also supports Linux ARM64. The installation page lists current stable packages by system.

Do I need to migrate my storage or existing links?

Keep supported storage services and your public domain. Add the configuration in img and verify an upload before changing your editor integration. Existing article links remain unchanged. Preview and import supported PicGo / PicList storage configuration; history and plugin runtimes are not imported.

GET STARTED

Download img