README

<div align="center" markdown="1"> <sup>Special thanks to:</sup> <a href="https://go.warp.dev/picgo"> </a>

Warp, the intelligent terminal for developers

</div> <div align="center" markdown="1"> <sup>Sponsored by:</sup> <a href="https://console.neon.tech/app/?promo=PicGo"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://neon.com/brand/neon-logo-dark-color.svg"> <source media="(prefers-color-scheme: light)" srcset="https://neon.com/brand/neon-logo-light-color.svg">

</picture>

</a>

Fast Postgres Databases for Teams and Agents

</div>

中文 | English

<div align="center"> <h1>PicGo</h1> <h3>The Ultimate Image Uploader for Efficient Creators</h3> <p align="center"> <a href="https://github.com/Molunerfinn/PicGo/actions">

</a>
<a href="https://github.com/Molunerfinn/PicGo/actions">
  
</a>
<a href="https://github.com/Molunerfinn/PicGo/releases">
  
</a>
<a href="https://github.com/Molunerfinn/PicGo/releases/latest">
  
</a>
<a href="https://github.com/PicGo/bump-version">
  
</a>

</p> </div>

📖 Overview

PicGo aims to make image uploading a seamless part of your creative workflow.

Whether you’re writing a blog post, taking notes, or authoring developer docs, PicGo helps you upload images in one step and automatically copies the resulting link—so you can stay focused on creating, not uploading.

Supported Image hosts

PicGo supports mainstream Image hosts out of the box, and can be extended indefinitely through its plugin system:

China cloud vendors: Qiniu, Tencent Cloud COS, UPYUN, Alibaba Cloud OSS
International / open platforms: GitHub, SM.MS(S.EE), Imgur
More options via plugins: AWS S3, Cloudflare R2, MinIO, and more

Note: PicGo itself will no longer add new third-party Image hosts by default. You can build Image host plugins yourself—see PicGo-Core.

✨ Key Features

PicGo is built around a fast, low-friction image upload experience:

⚡ Smooth writing flow

Auto-copy links: once an upload finishes, the link is copied to your clipboard automatically.
Flexible formats: Markdown, HTML, URL, custom templates—paste directly into any editor.
Zero-Context Switching: Don't switch windows. Just paste images directly into your favorite editor, and let PicGo handle the upload in the background.
- Enable this workflow via native support or community plugins: Obsidian \ VS Code \ Typora \ Neovim \ MarkText \ SiYuan \ And more...

🚀 Fast uploads

Multiple ways to upload: drag & drop, paste from clipboard, hotkeys, and even right-click context menu upload on macOS/Windows.
Global hotkey: press Command+Shift+U (macOS) / Ctrl+Shift+U (Windows/Linux) to open the upload window without leaving your current app. The global key can be customized.

🧩 Powerful plugin ecosystem

Highly extensible: plugins already exist for AWS S3, Cloudflare R2, MinIO, and many other Image hosts.
Even more possibilities: image compression, watermarking, renaming, Markdown image migration, and more.
- Explore plugins: Awesome-PicGo

🛠 Developer-friendly

HTTP API: upload via HTTP requests (v2.2.0+), making it easy to integrate with other tools.
Open source: fully open-source and transparent.
Great documentation: detailed docs help you get started quickly. For plugin development, see the PicGo-Core docs.

There’s more to discover—development progress is tracked in Projects.

If you’re new to PicGo, start with the User Guide. If you run into issues, check the FAQ and closed issues.

Download & Install

Source	Link / Installation	Platform	Notes
GitHub Releases	https://github.com/Molunerfinn/PicGo/releases	All	Downloads may be slow in mainland China
Shandong University mirror	https://mirrors.sdu.edu.cn/github-release/Molunerfinn_PicGo	All	Thanks to the mirror for hosting
Scoop	`scoop bucket add extras` & `scoop install picgo`	Windows	Thanks to @huangnauh and @Gladtbam
Chocolatey	`choco install picgo`	Windows	Thanks to @iYato
Homebrew	`brew install picgo --cask`	macOS	Thanks to @womeimingzi11
AUR	`yay -S picgo-appimage`	Arch Linux	Thanks to @houbaron
Nix	`nix-shell -p picgo`	Nix/NixOS	Thanks to @qrzbing

Screenshots

Development

Currently tested on macOS and Windows only. Linux has not been fully tested.

If you want to learn, contribute, modify, or build PicGo yourself:

For an Electron-vue learning series, see: Electron-vue development

Install Node.js and Git, and make sure you’re familiar with npm basics.
Clone the repo: git clone https://github.com/Molunerfinn/PicGo.git and enter the directory.
Install dependencies with pnpm. If you don’t have it yet, install it from the pnpm website first.
On macOS you’ll need Xcode; on Windows you’ll need Visual Studio.
For contributing, see CONTRIBUTING.md.

Development mode

Run pnpm run dev to start the dev workflow with hot reload. Note: dev mode can be unstable and the process may crash—if that happens:

bash

ctrl+c # stop dev mode
pnpm run dev # restart

On Windows, after dev mode starts, PicGo’s tray icon will appear in the bottom-right system tray area.

Production build

To build release artifacts locally, run pnpm run build. After a successful build, the installer files will be generated under dist.

Note: If your network is unstable, electron-builder may fail to download Electron binaries. You can set an alternative mirror before building:

bash

export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
# On Windows: set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ (no quotes)
pnpm run build

Electron binaries are stored under ~/.electron/. If you need to refresh them, delete that directory and rebuild.

vs-picgo: PicGo for VS Code.
flutter-picgo: mobile app (Android & iOS).
PicHoro: another mobile app compatible with PicGo config (Android only for now).

Sponsorship

If you like PicGo and it helps your workflow, feel free to buy me a coffee.

Alipay:

WeChat Pay:

GitHub Sponsors:

License

MIT