File Upload Configuration ​

Basic Description ​

As this section mainly relies on the original PicGo project, the documentation here is largely based on PicGo's manual with some additional modifications and supplements to fit PicList's usage.

The original PicGo manual can be found at：https://picgo.github.io/PicGo-Doc/zh/guide/config.html

The new or modified content in PicList will be marked in the document.

Configuration File Location PicList ​

The configuration file location of PicList varies depending on the operating system:

• Windows: %APPDATA%\piclist\data.json
• Linux: $XDG_CONFIG_HOME/piclist/data.json or ~/.config/piclist/data.json
• macOS: ~/Library/Application\ Support/piclist/data.json

For example, on Windows, you can find it at:

C:\Users\YourUserName\AppData\Roaming\piclist\data.json

On Linux, you can find it at:

~/.config/piclist/data.json

The location on macOS is similar to Linux.

Function Interface Partition ​

Upload Area ​

The upload area supports drag and drop uploading or clicking to open the file upload dialog.

It also supports uploading from the clipboard, uploading via URL, and other functions.

Image Preprocessing Settings 1.4.0+ ​

Starting from version V1.4.0, PicList supports built-in image preprocessing functions before uploading, including:

• Adding watermarks
• Image compression
• Image scaling
• Image rotation
• Format conversion
• Remove EXIF information

These functions are designed to help users perform image preprocessing before uploading, reducing the space occupation in cloud storage.

Some PicGo plugins, such as picgo-plugin-watermark and picgo-plugin-compress, can also provide similar functionalities. However, these plugins have not been maintained for a long time and may not be as efficient as the built-in preprocessing functions in PicList. We recommend that you use the built-in module rather than the plugins.

Adding Watermarks ​

PicList supports two types of watermark adding: text watermark and image watermark.

The supported configuration parameters are:

"isAddWatermark": boolean, // Whether to add watermarks
"watermarkType": "text" | "image", // Watermark type
"isFullScreenWatermark": boolean, // Whether to add full-screen watermarks
"watermarkDegree": number, // Watermark rotation angle
"watermarkText": string, // Watermark text
"watermarkFontPath": string, // Watermark font path
"watermarkScaleRatio": number, // Watermark scale ratio relative to the original image
"watermarkColor": string, // Watermark color
"watermarkImagePath": string, // Watermark image path
"watermarkPosition": string // Watermark position

"isAddWatermark": boolean, // Whether to add watermarks
"watermarkType": "text" | "image", // Watermark type
"isFullScreenWatermark": boolean, // Whether to add full-screen watermarks
"watermarkDegree": number, // Watermark rotation angle
"watermarkText": string, // Watermark text
"watermarkFontPath": string, // Watermark font path
"watermarkScaleRatio": number, // Watermark scale ratio relative to the original image
"watermarkColor": string, // Watermark color
"watermarkImagePath": string, // Watermark image path
"watermarkPosition": string // Watermark position

Text Watermark ​

Supported configurable parameters include:

• Watermark text
• Watermark font
• Watermark color
• Watermark rotation angle
• Scale ratio of the watermark to the original image
• Watermark position

The default font for text watermarks is simhei.ttf. The font will download from the network the first time you use the image uploading function.You can also provide your own font.

Image Watermark ​

Supported configurable parameters for image watermarks include:

• Watermark image path
• Watermark rotation angle
• Scale ratio of the watermark to the original image
• Watermark position

The default image watermark is PicList's text logo, but you can provide your own image watermark.

Image Editing ​

Image editing includes image compression, image scaling, and image rotation. Supported configurable parameters include:

"quality": number, // Image compression quality 0-100
"isReSize": boolean, // Whether to resize by a fixed size
"reSizeWidth": number, // Resized width
"reSizeHeight": number, // Resized height
"isReSizeByPercent": boolean, // Whether to resize by percentage
"reSizePercent": number, // Scaling percentage
"isRotate": boolean, // Whether to rotate
"rotateDegree": number, // Rotation angle
"isFlip": boolean, // Whether to flip vertically
"isFlop": boolean // Whether to flip horizontally

"quality": number, // Image compression quality 0-100
"isReSize": boolean, // Whether to resize by a fixed size
"reSizeWidth": number, // Resized width
"reSizeHeight": number, // Resized height
"isReSizeByPercent": boolean, // Whether to resize by percentage
"reSizePercent": number, // Scaling percentage
"isRotate": boolean, // Whether to rotate
"rotateDegree": number, // Rotation angle
"isFlip": boolean, // Whether to flip vertically
"isFlop": boolean // Whether to flip horizontally

Note that PicList provides two scaling modes: scaling by a fixed size and scaling by percentage. These two scaling modes are mutually exclusive, so you can only choose one.

The priority is: scaling by percentage > scaling by fixed size.

Format Conversion ​

Supported formats for conversion include:

Remove EXIF Information ​

EXIF information is the metadata of the image, including shooting time, shooting equipment, shooting location, etc. Sometimes we do not want this information to be leaked, so PicList provides the function of removing EXIF information.

When enabled, the uploaded image will not contain EXIF information.

Using CLI Command Line ​

PicList's image preprocessing feature supports command line usage, and you need to install PicList Core. Please refer to the README for specific installation methods.

After installation, you can use the picgo set buildin watermark command to set the watermark adding function and the picgo set buildin compress command to set the image editing function. Then, you can upload images by using the picgo upload command.

Clipboard Image Upload ​

By clicking the Clipboard Image button, you can upload images in the clipboard.

By default, the script is used to get clipboard images. You can open Use Built-in Clipboard Upload in the settings to use Electron's built-in clipboard module to obtain them.

Besides, you can open or close the clipboard upload function by right-clicking the taskbar tray icon, mini window, or MacOS's top bar and dock icon. When it is turned on, PicList will monitor the images in the clipboard. When an image is detected, it will be uploaded automatically.

Upload via URL ​

You can upload images via URL, and the URL must start with "http" or "https".

URLs must contain the image extension, such as https://example.com/test.jpg, otherwise the upload may fail.

PicList will specially process the image extension for images from WeChat official accounts, so you can directly copy the image link from WeChat official accounts to upload.

Gallery Area ​

It supports viewing all the images you have successfully uploaded. Clicking on an image allows you to preview it. Clicking the icon below the image allows you to copy the link or delete the image. You can control whether to delete cloud images by selecting the Sync Delete Cloud option in the upper right corner.

Edit Image Information ​

Sometimes, you may need to modify the URL of the uploaded image later, such as changing "http" to "https", or adding some operation suffixes (e.g., ?imgslim supported by Qiniu). You can click the "Edit" button to modify it.

Select Link Format to Copy ​

You can quickly switch the link format you want to copy in the album area.

Select All and Shift Multi-selection Support ​

The album operation area supports Select All operation and also supports simple multi-selection across images using the Shift key.

Cloud Delete PicList+ ​

In PicList, you can control whether to delete cloud images by selecting the Sync Delete Cloud option in the upper right corner of the album.

Currently supported image hosts or plugins include:

• SM.MS
• Imgur
• Github
• Tencent Cloud COS V5
• Ali Cloud OSS
• Qiniu Cloud KODO
• Upyun
• WebDAV
• local path
• picgo-plugin-s3

Advanced Search and Sort PicList+ ​

Advanced features can be found in the toolbar at the top of the album.

In PicList, in addition to the basic cloud classification and file name search of PicGo, there are also functions of searching by upload time and searching by URL.

Additionally, both file name and URL searches support regular expressions. For example, \d{4}-\d{2}-\d{2} can match date formats such as 2020-01-01.

The final result is the intersection of all search conditions.

In addition, PicList adds sorting functions in the album, which supports sorting by file name, file extension, upload time, or selected status.

Clicking again in the same way can toggle the sort direction.

Batch Modify URL PicList+ ​

Click the Modify button in the toolbar at the top of the album to pop up the dialog for batch modifying the URL.

Batch modification is performed by matching the URL with a regular expression and then replacing it with a specified string. In the string, special placeholders can be used for replacement.

The supported placeholders are:

Short Link PicList+ ​

PicList supports short link function, which can be found in the top toolbar of the album, supporte c1n.cn and Yourls.

After enabling the short link function, when copying the image link, the image link will be automatically converted to a short link.

Image Host Settings ​

SM.MS ​

Official website: https://sm.ms, for users in Mainland China, please visit https://smms.app

Official documentation: https://doc.sm.ms/

Configuration ​

{
  "_configName": "", // Image host configuration name
  "token": "", // SM.MS token, required
  "backupDomain": "" // Backup domain, optional
}

{
  "_configName": "", // Image host configuration name
  "token": "", // SM.MS token, required
  "backupDomain": "" // Backup domain, optional
}

Explanation ​

Register and log in to the smms backend to obtain the token value.

Qiniu Cloud ​

Official website: https://www.qiniu.com/

Official documentation: https://developer.qiniu.com/kodo

Configuration ​

{
  "_configName": "", // Configuration name
  "accessKey": "",
  "secretKey": "",
  "bucket": "", // Bucket name
  "url": "", // Access URL
  "area": "", // Storage area code
  "options": "", // URL suffix, such as ?imgslim
  "path": "" // Custom storage path, such as img/
}

{
  "_configName": "", // Configuration name
  "accessKey": "",
  "secretKey": "",
  "bucket": "", // Bucket name
  "url": "", // Access URL
  "area": "", // Storage area code
  "options": "", // URL suffix, such as ?imgslim
  "path": "" // Custom storage path, such as img/
}

Explanation ​

accessKey & secretKey ​

You need to create or view your accessKey and secretKey in the Qiniu Cloud

bucket & area ​

Access https://portal.qiniu.com/kodo/bucket to create buckets, view your bucket list and corresponding storage areas.

Please set the bucket permissions to public read, otherwise the uploaded images cannot be displayed in the album.

Please visit the Qiniu Cloud official documentation - Storage Region or refer to the table below for codes.

url ​

The access URL is the test domain name assigned by Qiniu Cloud or the domain name you bind yourself. If you have not bound a domain name, you can see how to bind a domain name in the Qiniu Cloud official documentation - Binding Domain Name.

The bound domain name must be a domain name that has been filed, otherwise it cannot be accessed normally.

When filling in, be sure to add http:// or https://.

path/Storage Path ​

The storage path is an optional field. If it is not filled out, it will be stored in the root directory of the bucket by default.

For example, if you fill in images/test/, the file will be stored in the corresponding test directory.

Don't forget the trailing /.

options/Website suffix ​

Qiniu Cloud provides image processing functions, which are generally used for operations such as cropping, scaling, rotating, and adding watermarks to images.

Usage: add the website suffix to the external network access address of the file, for example: http://xxx.com/xxx.jpg?imageView2/2/w/500/h/500, which will crop the image to a thumbnail of 500x500.

For detailed usage of website suffixes, please refer to Image Style.

If the usage of this function exceeds the free quota, additional processing fees will be incurred. For specific fees, please refer to Image Processing Fees.

The website suffix is an optional field. If it is not filled out, the original address will be copied.

Tencent Cloud COS ​

Official website: https://www.tencentcloud.com/products/cos

Official documentation: https://www.tencentcloud.com/document/product/436

Configuration ​

{
  "_configName": "", // Image hosting configuration name
  "secretId": "",
  "secretKey": "",
  "bucket": "", // Storage bucket name, different for v4 and v5 versions
  "appId": "", // For example, 1250000000
  "area": "", // Storage area, such as ap-beijing-1
  "path": "", // Custom storage path, such as img/
  "customUrl": "", // Custom domain name, be sure to include http:// or https://
  "version": "v5" | "v4" // COS version, v4 or v5
}

{
  "_configName": "", // Image hosting configuration name
  "secretId": "",
  "secretKey": "",
  "bucket": "", // Storage bucket name, different for v4 and v5 versions
  "appId": "", // For example, 1250000000
  "area": "", // Storage area, such as ap-beijing-1
  "path": "", // Custom storage path, such as img/
  "customUrl": "", // Custom domain name, be sure to include http:// or https://
  "version": "v5" | "v4" // COS version, v4 or v5
}

V4 Version Instructions ​

Please refer to the PicGo official manual.

As the V4 version is already quite old, PicList will no longer actively update V4-related features and will not consider removing support in the future.

V5 Version Instructions ​

secretId & secretKey & appId ​

You need to create or view your secretId, secretKey, and appId in the Tencent Cloud API Key Management page.

bucket & area ​

Create a bucket and view your bucket list and corresponding storage areas.

The format of the bucket is bucketname-appId, where appId corresponds to the above appId.

Please set the storage bucket permissions to public read, otherwise uploaded images will not be displayed in the album.

Please visit the Tencent Cloud Official Document - Regions and Access Endpoints or refer to the table below to query the code.

path/storage path ​

The storage path is an optional item. If not filled in, it will be stored in the root directory of the bucket by default.

For example, if you fill in images/test/, the file will be stored in the corresponding test directory.

customUrl/Custom Domain ​

Custom domain is an optional feature. If not specified, Tencent Cloud's default public domain will be used for actions such as copying links or previewing images.

For example, if the file test.jpg is stored in the directory images/test/, the bucket name is test-1250000000, and the storage region is ap-beijing, then the default public domain will be test-1250000000.cos.ap-beijing.myqcloud.com, and the file access URL will be https://test-1250000000.cos.ap-beijing.myqcloud.com/images/test/test.jpg.

However, if a custom domain is specified, the public access URL for the file will be http://custom-domain/images/test/test.jpg.

options/Website Suffix ​

Tencent Cloud provides image processing capabilities, generally used for operations such as image cropping, scaling, rotating, and watermarking.

Usage: add the website suffix after the public access URL of the file, such as https://test-1250000000.cos.ap-beijing.myqcloud.com/images/test/test.jpg?imageMogr2/thumbnail/500x500.

For detailed website suffix usage, please refer to the Image Processing Guide.

If the usage of this feature exceeds the free quota, additional processing fees will be charged. For specific fees, please refer to the Image Processing Fees.

The website suffix is optional. If not specified, the original address will be copied.

Upyun ​

Official Website: https://www.upyun.com/

Official Documentation: https://docs.upyun.com/api/

Configuration ​

{
  "_configName": "", // Configuration name for the image hosting service
  "bucket": "", // Storage space name, which is your service name
  "operator": "", // Operator name
  "password": "", // Password for the operator
  "options": "", // Some suffix processing parameters for images
  "path": "", // Custom storage path, such as img/
  "url": "" // Accelerated domain name, be sure to include http:// or https://
}

{
  "_configName": "", // Configuration name for the image hosting service
  "bucket": "", // Storage space name, which is your service name
  "operator": "", // Operator name
  "password": "", // Password for the operator
  "options": "", // Some suffix processing parameters for images
  "path": "", // Custom storage path, such as img/
  "url": "" // Accelerated domain name, be sure to include http:// or https://
}

Description ​

bucket ​

You can create a service (corresponding to a bucket) and view the service list by visiting https://console.upyun.com/services/file/.

operator & password ​

After entering the service, click on Storage Management, and you can view and modify the operator at the bottom. The password is the corresponding password of the operator.

It is recommended to grant the operator read, write, and delete permissions.

url/Accelerated Domain Name ​

The accelerated domain name is a test domain name assigned by Upyun or a domain name bound by yourself. If you have not bound a domain name, you can learn how to bind it in Upyun Official Documentation-How to create a CDN service for self-hosted sources?.

The bound domain name must be a pre-registered domain name, otherwise it cannot be accessed normally.

Be sure to include http:// or https://.

path/Storage Path ​

The storage path is an optional item. If not filled in, it will be stored in the root directory of the bucket by default.

For example, if you fill in images/test/, the file will be stored in the corresponding test directory.

options/Website Suffix ​

Upyun provides a free image processing function, which is generally used for operations such as cropping, scaling, rotating, and watermarking.

Parameter format:

Image URL + delimiter + parameters or thumbnail version

Image URL + delimiter + parameters or thumbnail version

For detailed suffix usage, please refer to Image Processing.

The website suffix is an optional item. If not filled in, the original address will be copied.

GitHub ​

Official Website: https://www.github.com

Official Documentation: https://docs.github.com/en/rest

Configuration ​

{
  "_configName": "", // Image hosting configuration name
  "repo": "", // Repository name in the format of username/reponame
  "token": "", // Github token
  "path": "", // Custom storage path, e.g. img/
  "customUrl": "", // Custom domain name, be sure to add http:// or https://
  "branch": "" // Branch name, default is main
}

{
  "_configName": "", // Image hosting configuration name
  "repo": "", // Repository name in the format of username/reponame
  "token": "", // Github token
  "path": "", // Custom storage path, e.g. img/
  "customUrl": "", // Custom domain name, be sure to add http:// or https://
  "branch": "" // Branch name, default is main
}

Description ​

repo/Repository Name ​

Register an account on https://github.com and get your username after successful registration.

Create a new repository, and if it is used as an image hosting, remember to create a public repository.

Then fill in the username/reponame format according to your own repository.

token ​

Access: https://github.com/settings/tokens, and then click Generate new token(Classic).

Check the repo box and set the expiration time according to your needs. Then scroll down to the bottom of the page and click the green Generate token button to generate the token.

path/Storage path ​

Optional parameter used to specify the image storage path. If not filled in, it will be stored in the root directory of the repository by default.

branch ​

Optional parameter used to specify the image storage branch. If not filled in, it will be stored in the default branch by default.

customUrl/Custom domain name ​

Optional parameter used to specify the custom domain name of the image, usually used for CDN acceleration.

For example, if jsDelivr acceleration is used, you can fill in https://cdn.jsdelivr.net/gh/{github username}/{reponame}@{branch}/, where {github username}, {reponame}, and {branch} correspond to the Github username, repository name, and branch name, respectively.

Alibaba Cloud ​

Official website: https://www.aliyun.com/product/oss

Official documentation: https://help.aliyun.com/product/31815.html

Configuration ​

{
  "_configName": "", // Image hosting configuration name
  "accessKeyId": "",
  "accessKeySecret": "",
  "bucket": "", // Bucket name
  "area": "", // Storage area code
  "path": "", // Custom storage path
  "customUrl": "" // Custom domain name, be sure to add http:// or https://
}

{
  "_configName": "", // Image hosting configuration name
  "accessKeyId": "",
  "accessKeySecret": "",
  "bucket": "", // Bucket name
  "area": "", // Storage area code
  "path": "", // Custom storage path
  "customUrl": "" // Custom domain name, be sure to add http:// or https://
}

Description ​

accessKeyId & accessKeySecret ​

You need to create or view your accessKeyId and accessKeySecret in the Alibaba Cloud AccessKey management page, which can be accessed in two ways:

1. Access management page URL directly
2. After logging in to Alibaba Cloud, click the avatar in the upper right corner, and select AccessKey management.

bucket & area ​

Please set the storage bucket permission to public read in Aliyun Console > Object Storage Service (OSS) > Bucket List, or directly visit https://oss.console.aliyun.com/bucket to view your bucket list and corresponding storage regions.

If the storage bucket permission is not set to public read, the uploaded images will not be displayed in the album.

Please refer to the following table to find the corresponding code or visit the official Aliyun documentation.

path/Storage path ​

Path is an optional field. If not specified, the file will be stored in the root directory of the bucket.

For example, if you enter images/test/, the file will be stored in the corresponding test directory.

customUrl ​

Custom URL is an optional field. If not specified, the default external domain name of Aliyun will be used when copying links, previewing images, and other operations.

For example, if the file test.jpg is stored in the directory images/test/, the bucket name is test-bucket, and the storage region is Hangzhou 1, the external access address of the file is https://test-bucket.oss-cn-hangzhou.aliyuncs.com/images/test/test.jpg.

If you specify a custom domain name, the external access address of the file will be http://customdomain/images/test/test.jpg.

Please note to include http:// or https://.

options/Website suffix ​

Alibaba Cloud OSS provides image processing functions, which are commonly used for operations such as cropping, scaling, rotating, and watermarking of images.

To use this function, append the website suffix to the external network access address of the file, for example, https://test-bucket.oss-cn-hangzhou.aliyuncs.com/images/test/test.jpg?x-oss-process=image/resize,m_fill,h_100,w_100.

For detailed usage of website suffix, please refer to OSS New Image Processing Guide.

If the usage of this function exceeds the free quota, additional processing fees will be charged. For specific fees, please refer to OSS Image Processing Fees.

The website suffix is optional. If left blank, the original address will be copied.

Imgur ​

Official website: https://imgur.com/

Official documentation: https://apidocs.imgur.com/

Configuration ​

{
  "_configName": "", // Configuration name
  "clientId": "", // Imgur clientId
  "username": "", // imgur username
  "accessToken": "", // imgur accessToken
  "album": "", // imgur album name
  "proxy": "" // Proxy address, only supports http proxy
}

{
  "_configName": "", // Configuration name
  "clientId": "", // Imgur clientId
  "username": "", // imgur username
  "accessToken": "", // imgur accessToken
  "album": "", // imgur album name
  "proxy": "" // Proxy address, only supports http proxy
}

Description ​

clientId ​

If you haven't generated a clientId yet, please log in to Imgur first, then go to https://api.imgur.com/oauth2/addclient, fill in the Application name, chooseOAuth 2 authorization without a callback URL for Authorization Type, and click Submit to generate a clientId.

If you have already generated a clientId, log in to the Imgur website, click on the profile picture in the upper right corner, choose Settings, and you can find it on the Applications page.

Or visit https://imgur.com/account/settings/apps to view it directly.

username/accessToken ​

If you want to upload images to your own account, you need to fill in the username and accessToken fields.

If you have not generated an accessToken, please log in to Imgur first, then visit https://api.imgur.com/oauth2/authorize?client_id={clientId}&response_type=token, where {clientId} is your clientId, click Allow, at this time the browser address bar will jump to https://imgur.com/#access_token={accessToken}&expires_in=315360000&token_type=bearer&refresh_token={refreshToken}&account_username={username}&account_id={accountId}, where {accessToken} is your accessToken.

album/Album name ​

Album name is an optional field. If not filled in, the uploaded image will not be added to the album.

proxy/http proxy ​

Due to well-known reasons, Imgur cannot be accessed in mainland China under normal circumstances, so please configure the proxy yourself.

The format of the proxy is http(s)://127.0.0.1:{port}, where {port} is the proxy port number.

WebDAV ​

WebDAV

Configuration ​

{
  "_configName": "", // Configuration name
  "host": "", // WebDAV address
  "username": "", // Username
  "password": "", // Password
  "path": "", // Storage path
  "webpath": "", // Web path
  "customUrl": "", // Custom domain
  "sslEnabled": boolean // Whether to enable SSL
}

{
  "_configName": "", // Configuration name
  "host": "", // WebDAV address
  "username": "", // Username
  "password": "", // Password
  "path": "", // Storage path
  "webpath": "", // Web path
  "customUrl": "", // Custom domain
  "sslEnabled": boolean // Whether to enable SSL
}

Description ​

host ​

Required parameter used to specify the domain name of WebDAV, which can be an IP address or a domain name. If an IP address is used, please specify the port number.

username & password ​

Required parameters used to specify the username and password for WebDAV.

path/Storage path ​

The storage path is an optional parameter. If not filled in, it will be stored in the root directory of WebDAV by default.

For example, if you fill in images/test/, the file will be stored in the corresponding test directory.

webpath/Web path ​

Web path is an optional parameter. If not filled in, it will be the same as the storage path by default.

This path is used to splice the image access address. For example, if you fill in images/test/, the image access address will be https://host/images/test/.

customUrl ​

The custom domain is an optional parameter. If not filled in, the host domain name will be used for copying links, previewing images, and other operations.

sslEnabled ​

Please choose whether to enable SSL based on whether your WebDAV is accessed via HTTPS.

Local image hosting ​

Local image hosting refers to using a local folder as an image hosting service. The uploaded images will be stored in the folder. For example, you can use Rclone to mount cloud storage to a local path, and then use the path as a local image hosting service.

配置项 ​

{
  "_configName": "", // Image hosting configuration name
  "path": "", // Storage path
  "customUrl": "", // Custom domain name, be sure to add http:// or https://
  "webPath": "" // Web path
}

{
  "_configName": "", // Image hosting configuration name
  "path": "", // Storage path
  "customUrl": "", // Custom domain name, be sure to add http:// or https://
  "webPath": "" // Web path
}

说明 ​

path ​

Required parameter used to specify the storage path of the local image hosting service.

customUrl ​

Custom domain name is an optional parameter. If not filled in, the local path above will be used when copying links, previewing images, and other operations.

webpath ​

Web path is an optional parameter. If not filled in, it will be the same as the storage path by default.

This path is used to splice the image access address. For example, if you fill in images/test/, the image access address will be https://host/images/test/.

Other image hosting services ​

PicList is compatible with PicGo's plugin ecosystem. Please use plugins for other image hosting services.

PicList plans to integrate more image hosting services into the built-in functionality in the future, so stay tuned.

General Settings ​

System Settings ​

Language ​

PicList currently supports three languages: Simplified Chinese, Traditional Chinese, and English. You can choose your favorite language here.

Startup mode ​

PicList supports startup mode selection, of which Windows and Linux systems support the following startup modes:

• Silent startup: PicList will run in the background without displaying a window, but will display an icon in the system tray.
• Mini window: PicList will display an icon in the system tray and automatically display the mini window.
• Main window: PicList will display an icon in the system tray and automatically display the main window.

Mac systems support the following startup modes:

• Silent startup: PicList will run in the background without displaying a window, but will display an icon in the top bar.
• Hide top bar: PicList will not display an icon in the top bar, but will display an icon in the Dock bar.
• Main window: PicList will display an icon in the top bar and automatically display the main window.

Note that PicList also supports turning on or off the dock bar icon, but does not allow turning off both the top bar and dock bar icons at the same time.

Default main window size ​

You can set the default size of the main window when it starts, the default value is 1200x800.

If you choose Original PicGo size, it will be the same as PicGo, and the size when it starts will be 800x450.

Mini Window Always on Top ​

If you choose to enable this option, the mini window will always be displayed on top of other windows.

Custom mini window icon ​

You can use your favorite icon to replace the icon of the mini window.

Startup on boot ​

Choose whether to start up on boot.

Customize shortcuts ​

The default upload shortcut is Cmd+Shift+P [Mac] or Ctrl+Shift+P [Windows].

Click on PicList settings in the sidebar to modify the shortcuts. This will open the shortcut panel, where you can choose to enable or disable shortcuts:

Click "Edit", then click the input box in the opened dialog, and press the shortcut keys you want (it can also be a combination of keys). Then click OK to save (otherwise it will not take effect!).

Plugins can also add their own shortcuts, and the added shortcuts will be displayed in the shortcut panel.

Sync and Configurations ​

Set configuration synchronization ​

You can set the synchronization configuration here. Currently, PicList supports using Github or Gitee for configuration synchronization.

Files that need to be synchronized include data.json, data.bak.json that save the general configuration, and manage.json, manage.bak.json that save the management interface configuration.

Parameters that need to be set include:

{
  "type": "github", // github or gitee
  "username": "", // username
  "repo": "", // repository name
  "branch": "", // branch name
  "token": "", // token
  "proxy": "" // proxy
}

{
  "type": "github", // github or gitee
  "username": "", // username
  "repo": "", // repository name
  "branch": "", // branch name
  "token": "", // token
  "proxy": "" // proxy
}

Upload and download configuration files 1.8.4+ ​

After setting the synchronization configuration, you can manually upload or download the configuration file here.

Currently, PicList does not support automatic synchronization.

Migration from PicGo 1.5.0+ ​

If you have used PicGo before, you can migrate the PicGo configuration to PicList here. The imported configuration includes the data.json file and the album file.

Open configuration file ​

You can click to open the data.json file. Please do not modify this file at will, otherwise PicList may not work properly.

Upload Settings ​

Auto import configuration on management page ​

After turning on, PicList will automatically import the image hosting information that has been configured in the image hosting every time you open the management page.

Synchronize cloud files when deleting from album PicList+ ​

When turned on, when you delete a picture in the album, the cloud file will be automatically deleted.

You can also adjust the setting by clicking the Sync Delete Cloud button in the upper right corner of the album interface.

Upload Prompt ​

After opening, a prompt box will pop up every time you upload an image to indicate that it is uploading.

If you find that it has no effect after opening, please pay attention to whether you have turned off the system-level message notification option.

Set image watermark and compression-format conversion parameters ​

Please refer to Image Preprocessing Settings.

Manually rename before uploading ​

If you want to have a chance to change the file name of your image before uploading, you can choose to enable renaming before uploading.

After that, a small window will pop up when you upload, allowing you to rename the file.

If you do not want to rename, you can click OK, Cancel, or simply close the window. If you want to rename, enter the desired name in the input box, then click OK. This feature also supports batch uploading.

Automatic timestamp naming ​

When turned on, it will automatically replace the uploaded file name with a timestamp to avoid file name duplication or to protect privacy.

Advanced renaming ​

Advanced renaming supports the following placeholders:

Please combine according to your own needs, for example:

{Y}{m}{d}-{md5-16}

{Y}{m}{d}-{md5-16}

Delete local pictures after uploading ​

After turning on, PicList will automatically delete the local pictures after each successful upload.

Auto Copy URL After Upload ​

Enabled by default, it will automatically copy the URL to the clipboard after uploading.

Customize link format ​

PicList has built-in five link formats:

• Markdown：![Image name](Image link)
• HTML：<img src="Image link" />
• URL：Image link
• UBB：[img]Image link[/img]
• Custom

Custom supports using three variables: $fileName, $extName, and $url, which represent the file name, file extension, and image link, respectively. For example, you can set it to $url?x-oss-process=image/resize,m_fill,h_100,w_100, so that the Alibaba Cloud OSS image processing function can be automatically added after uploading.

Shorten URL ​

Short link service provided by c1n, which can convert long links into short links.

Encode URL when copying ​

Close by default. After turning on, the special characters in the URL will be escaped, such as # will be escaped to %23.

The built-in image hosting in PicList has been escaped when outputting the URL, so in most cases you don't need to turn on this option.

Use Built-in Clipboard to Upload ​

If you encounter problems with clipboard uploads, such as residual processes, you can consider enabling this option.

Automatically listen for clipboard uploads when the software starts ​

Closed by default. After turning on, the clipboard upload will be automatically monitored when the software starts.

Select the image hosting service to display ​

So in order to simplify the display, you can choose only the image bed you want to display, so that the sidebar will not have a scroll bar. However, it should be noted that this only shows/hides and does not remove the corresponding functionality. If you hide Qiniu Cloud, you can still upload images through Qiniu Cloud.

Advanced Settings ​

Set log file ​

You can open and view the log file in this setting, and also set the output log type (such as success, failure, or no output, etc.).

In addition, PicList will actively control the size of the log file, with a default maximum of 10MB, and will automatically clean up the log file after it exceeds this size.

Proxy Settings ​

Support simple HTTP proxy settings. Click on Set Proxy to access.

• For the proxy during upload, please configure Upload Proxy
• If it is for the proxy for plugin installation, please configure Plugin Installation Proxy
• If it is for the setting of the npm mirror source during plugin installation, you can set Plugin Mirror Address

PicGo-Server Settings ​

PicList will internally enable a small server by default, which is used in conjunction with other applications to call for uploading. If you need to use applications such as Typora and Obsidian to upload images, you need to enable this feature.

The recommended listening address is the default 127.0.0.1 (local), and the recommended port is the default 36677.

Update Settings ​

Check for Updates ​

Used to actively initiate update checks. If there is a new version, you will be prompted to update.

Switch update assistant ​

PicList will check for the latest version every time it starts. If the current version is lower than the latest version, you will be prompted to update. If you do not want to receive this message, you can turn off the Open update assistant option in settings.

Plugin Settings ​

You can install, update, disable, uninstall, configure, and use all PicGo plugins through the Plugin page.

Install Plugins ​

Search for the plugin name in the search bar of the plugin interface. The plugin name starts with picgo-plugin-, so you only need to search for the name after the prefix. For example, a picgo-plugin-wow plugin, you only need to search for wow.

After finding the plugin, just click Install in the lower right corner. If you encounter the prompt that the plugin is not optimized for GUI, you can ask the plugin author whether the plugin is suitable for use in PicGo software, otherwise it may only be a command-line plugin.

Offline Installation ​

PicList supports importing local plugins (folders). The import requirement is a complete picgo plugin folder. It can be used to offline install picgo plugin packages or plugin developers for self-testing. The entry for importing plugins is on the right side of the title bar in the Plugin Settings page:

Update Uninstall and Disable ​

All of them can be selected in the menu that pops up when you click the gear button in the lower right corner of the plugin.

Plugin Configuration ​

Some plugins have configuration items or their own menu items, which can be configured directly by clicking the gear in the lower right corner:

Look for more plugins ​

You can find super awesome PicGo plugins in the Awesome-PicGo of PicGo official, and PicList is compatible with all these plugins.

Plugin Development ​

If you want to develop plugins, you can refer to the plugin development documentation of PicGo.