<div align="center"> <a href="https://piclist.cn"> <img src="https://imgx.horosama.com/admin_uploads/2022/10/2022_10_05_633d79e401694.png" alt="PicList Logo" width="120" height="120"> </a> <h1>PicList</h1> <p> <strong>A powerful cloud storage and image hosting management tool.</strong> </p> <p> <a href="https://github.com/Kuingsmile/PicList/actions"> <img src="https://img.shields.io/badge/code%20style-standard-green.svg?style=flat-square" alt="Code Style"> </a> <a href="https://github.com/Kuingsmile/PicList/releases"> <img src="https://img.shields.io/github/downloads/Kuingsmile/PicList/total.svg?style=flat-square" alt="Downloads"> </a> <a href="https://github.com/Kuingsmile/PicList/releases/latest"> <img src="https://img.shields.io/github/release/Kuingsmile/PicList.svg?style=flat-square" alt="Release"> </a> <a href="https://github.com/Kuingsmile/PicList/blob/dev/LICENSE"> <img src="https://img.shields.io/github/license/Kuingsmile/PicList?style=flat-square" alt="License"> </a> </p> <p> <a href="https://github.com/Kuingsmile/PicList/blob/dev/README_cn.md">简体中文</a> | <a href="https://github.com/Kuingsmile/PicList/blob/dev/README.md">English</a> </p> </div> <br> <div align="center"> <img src="https://repobeats.axiom.co/api/embed/9e4ec90b7b50f8e9c10d77439e49e26b303fabed.svg" alt="Repobeats analytics image" width="100%"> </div>

📖 Introduction

PicList is an efficient cloud storage and image hosting management tool built upon the foundation of PicGo. It retains all the features of PicGo while adding comprehensive cloud storage management capabilities, various practical functions, and a brand-new lightweight scripting system.

Whether you need to organize your cloud files, sync markdown images, or manage multiple storage platforms effortlessly, PicList is designed to streamline your workflow with a beautiful interface and robust plugin system.

✨ Key Features

📂 comprehensive Cloud Management: Browse, search, cloud-delete, and batch rename files in your cloud storage.
🔄 Advanced Sync: Cloud-sync album deletion and configuration/gallery synchronization across multiple devices (via WebDAV/Git).
🎨 Built-in Image Tools: Watermark, compress, scale, rotate, and format conversion out of the box, controllable at individual image bed level.
📝 Scripting System: Customize lifecycle scripts to meet advanced user needs without requiring a node environment.
🌈 Theme Support: Multiple built-in themes, theme repository PicList ThemeHub, also supports custom themes and backgrounds.
🔌 Wide Compatibility: Compatible with Typora, Obsidian, and most existing PicGo plugins.
🛠️ Power User Features: Regex-based batch renaming, upload queues, local/sftp hosting, and more.
🌐 Web & Mobile: Support for form uploads and integration with the mobile app PicHoro.

📸 Screenshots

<details open> <summary><strong>Upload Interface</strong></summary> <br> <div align="center"> <img src="https://github.com/Kuingsmile/PicList/blob/dev/imgs/upload.webp?raw=true" alt="Upload Interface" width="100%"> </div> <div align="center"> <img width="2098" height="1398" alt="Image" src="https://github.com/Kuingsmile/PicList/blob/dev/imgs/anime.webp?raw=true" /> </div> </details> <details open> <summary><strong>More Views (Gallery, Settings, Task)</strong></summary> <br> <table align="center"> <tr> <td><img src="https://github.com/Kuingsmile/PicList/blob/dev/imgs/gallery.webp?raw=true" alt="Gallery"></td> <td><img src="https://github.com/Kuingsmile/PicList/blob/dev/imgs/cloud_storage.webp?raw=true" alt="Cloud Storage"></td> </tr> <tr> <td><img src="https://github.com/Kuingsmile/PicList/blob/dev/imgs/settings.webp?raw=true" alt="Settings"></td> <td><img src="https://github.com/Kuingsmile/PicList/blob/dev/imgs/task.webp?raw=true" alt="Task"></td> </tr> <tr> <td><img src="https://github.com/Kuingsmile/PicList/blob/dev/imgs/image_editing.webp?raw=true" alt="Settings"></td> <td><img src="https://github.com/Kuingsmile/PicList/blob/dev/imgs/dark.webp?raw=true" alt="Task"></td> </tr> </table> </details>

📥 Download & Install

💻 Desktop Applications

🐳 Docker

Run PicList with docker or docker-compose.

docker pull kuingsmile/piclist:latest

docker run -d \
  --name piclist \
  --restart always \
  -p 36677:36677 \
  -v "./piclist:/root/.piclist" \
  kuingsmile/piclist:latest \
  node /usr/local/bin/picgo-server -k piclist123456

🔌 Integrations

PicList integrates seamlessly with your favorite markdown editors.

VSCode

Install the VS-PicList extension for full integration.

Typora

Version ≥ 1.6.0: Select PicList directly in the Image settings settings.
Version < 1.6.0: Set 'Image Upload' -> 'PicGo(app)' and point the path to your PicList executable.

Obsidian

Install Image Auto Upload Plugin.
Set Default Uploader to PicGo(app).
API Endpoint: http://127.0.0.1:36677/upload

☁️ Supported Platforms

PicList supports a wide range of storage providers.

| Storage Provider | Album Delete | Cloud Management | | :-------------------------- | :----------: | :--------------: | | AWS S3 (and compatible) | ✅ | ✅ | | Aliyun OSS | ✅ | ✅ | | Tencent COS | ✅ | ✅ | | GitHub / Gitee | ✅ | ✅ | | S.EE / Imgur | ✅ | ✅ | | WebDAV / SFTP | ✅ | ✅ | | Local File System | ✅ | ✅ | | Lsky Pro / Doge Cloud | ✅ | ✅ |

Note: The cloud delete feature for custom API image hosts requires implementation via PicList's scripting system based on the specific API.

🚀 Development

We welcome contributions! Please see Contributing Guide for details.

Prerequisites

Node.js 20+
Git
Xcode (macOS) or Visual Studio (Windows) for native modules

Build from Source

# 1. Clone the repository
git clone https://github.com/Kuingsmile/PicList.git
cd PicList

# 2. Install dependencies
yarn

# 3. specific start dev mode
yarn run dev

# 4. Build for production
yarn run build

🔗 Related Projects

PicList ThemeHub: A theme repository for PicList.
PicList ScriptsHub: A script repository for PicList.
PicList-Core: The CLI core of PicList.
PicHoro: Android mobile client.

📄 License

This project is licensed under the MIT License.

</div>

PicList

Install / Use

README