# PicList

A desktop client for image uploads and cloud storage management, with PicGo ecosystem compatibility.

> This is the Markdown version of the PicList page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/piclist>

- **Latest version**: `3.6.1`
- **Developer**: Kuingsmile
- **Homepage**: <https://piclist.cn/>
- **Categories**: [Files and Storage](https://opennavo.com/categories/files-storage)
- **Install**: `brew install --cask piclist`
- **30-day installs**: 25
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/Kuingsmile/PicList/releases/download/v3.6.1/PicList-3.6.1-arm64.dmg>
- **SHA-256**: `81bbcd1e3e332c255b57957308743860b7b233f429a4bebd97dbaa29af48c63b`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "PicList.app"
      ],
      "target": "/Applications/PicList.app"
    },
    "phase": "install",
    "sources": [
      "PicList.app"
    ],
    "target": "/Applications/PicList.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/piclist",
            "~/Library/Preferences/com.kuingsmile.piclist.plist",
            "~/Library/Saved Application State/com.kuingsmile.piclist.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

PicList is a desktop client for image uploading and cloud storage management. Its official site describes compatibility with the PicGo ecosystem, including familiar upload workflows, configuration models, and plugins.

With PicList, you can manage cloud files across multiple platforms, including uploading, downloading, deleting, and organizing albums. It can also preprocess images before upload, with options for watermarks, compression, rotation, format conversion, and EXIF information handling. The official site additionally describes workflow extensions through a script system, command line, HTTP service, and mobile-device integration.

Install the macOS app with Homebrew Cask:

```sh
brew install --cask piclist
```

The supplied cask targets macOS 12 or later and installs `PicList.app` in `/Applications`. Select the app after installation to begin configuring and using it. This cask installs the PicList application, not a separate command-line-only package.

Sources: [PicList official site](https://piclist.cn/) · [Homebrew Cask definition](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/p/piclist.rb)

## System requirements

- macOS 12 or later · Version: 3.6.1 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/piclist.rb> · Checked 2026-11-22
  - <https://github.com/Kuingsmile/PicList/releases/download/v3.6.1/PicList-3.6.1-x64.dmg>
  - SHA-256: `91485fd9c97ce0da1ef212f7f744aa7aa2726339b32b30f17ed4fece636eadd6`
- macOS 12 or later · Version: 3.6.1 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/piclist.rb> · Checked 2026-11-22
  - <https://github.com/Kuingsmile/PicList/releases/download/v3.6.1/PicList-3.6.1-arm64.dmg>
  - SHA-256: `81bbcd1e3e332c255b57957308743860b7b233f429a4bebd97dbaa29af48c63b`

## PicList security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/Kuingsmile/PicList> · Open source: Yes — <https://github.com/Kuingsmile/PicList> · Checked 2026-11-14

## Uninstall

- `brew uninstall --cask piclist`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask piclist`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/piclist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/piclist.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.kuingsmile.piclist.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/piclist.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/com.kuingsmile.piclist.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/piclist.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 3.6.1 (2026-10-14)

Fixes null-proxy exceptions and improves cloud pagination; the release also documents UI, sync, upload, security and Core configuration changes.

### PicList 3.6.1 — Release notes

This summarizes the official v3.6.1 page, which lists both the 3.6.1 patch and broader release changes.

- 3.6.1 fixes exceptions when the proxy is `null`, improves cloud browsing pagination and adds quick access to recent files.
- Removes the built-in web upload page and its web server. Standalone PicList-Core CLI/server requires Node.js `22.13.0` or later in the `22.x` line, not an extra Node.js installation requirement for the desktop app. Configuration defaults to `~/.piclist/data.json`, falling back to `~/.piclist/config.json` only if absent; `data.json` wins when both exist.
- Redesigns gallery, cloud accounts, browsing, image processing and other pages. On-demand loading reduces large-list memory use, configuration writes and clipboard polling. Tray upload window support is Windows-specific.
- Adds SVG previews, synchronization change/conflict previews, local/remote/both resolution and summary export. Recovery snapshots support rollback and retention management. Batch URL edits, rename and move gain previews, conflict policies and failed-item retries.
- Upload shortcuts select host configurations; staged progress distinguishes primary/secondary hosts. Queues restore after restart; unfinished post-processing can retry without re-uploading. Experimental bundled Node/npm manages plugins; discovery gains download statistics and sorting.
- Per-bucket/repository link formats and default S3 `auto` ACL omit the ACL parameter. Switching accounts/folders cancels stale requests. Core adds an interactive terminal, `picgo init`, `--picbed`/`--configName`, isolated upload contexts and temporary-file replacement for local/SFTP uploads.
- Fixes false batch success, incorrect original-file deletion, duplicate same-name URL uploads, mixed configurations/caches, GitHub/S3 metadata and preview signatures. Fixes JPEG quality, HEIC/HEIF format labeling and EXIF, watermark and SVG processing.
- Fixes recursive cloud lists, download pause/resume, renaming, signed links, authentication, configuration and plugins. Mac fixes include close/minimize shortcuts, mini windows and custom icons; other-platform fixes are not Mac fixes.
- Security/services: upload API temporary files are created only after authentication; local preview is restricted to its cache directory and local connections; remote Markdown previews no longer execute embedded HTML. Fixes authenticated proxy URLs, Axios proxy compatibility and legacy plugin `json: false` responses.

#### Official sources
- [Official sources 1](https://github.com/Kuingsmile/PicList/releases/tag/v3.6.1)
- [Official sources 2](https://github.com/Kuingsmile/PicList/compare/v3.6.0...3d8192d11ceaa2bc46aa9ceaf9961f581b19698b)

## Facts and sources

- <https://opennavo.com/apps/piclist>
- <https://opennavo.com/apps/piclist/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/p/piclist.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/piclist>
- <https://github.com/Kuingsmile/PicList> · Checked 2026-11-14
