Configuration
PicList keeps upload destinations, cloud management accounts, and application preferences separate. Save multiple named configurations for one provider to switch accounts without re-entering credentials.
Configuration file location
| Environment | Default data directory |
|---|---|
| Windows installed build | %APPDATA%\piclist\ |
| Windows portable build | data\ beside the executable |
| macOS | ~/Library/Application Support/piclist/ |
| Linux | $XDG_CONFIG_HOME/piclist/; otherwise ~/.config/piclist/ |
| PicList-Core | ~/.piclist/ |
The desktop upload configuration is data.json, the manager configuration is manage.json, and the gallery database is piclist.db. If you changed the configuration location, use the actual path shown in the app.
Core 3.0 prefers ~/.piclist/data.json and reads the legacy config.json only when data.json does not exist. It does not merge both files. Use -c to select a configuration file explicitly.
Configurations contain credentials
Exports can include tokens, access keys, passwords, and sync credentials. Keep backups private and do not attach a complete configuration to an issue. Quit the app and back up data before editing files manually.
Upload area
Choose an input method in upload workflows. See image processing for global, provider, and named configuration overrides.
Gallery area
The gallery records uploads from this machine. It includes link formats, filters, bulk edits, and deletion. See gallery and links for the distinction between this history and the cloud file list.
Image host settings
Use the storage guides to configure your provider. Saving a configuration and choosing it as the default are separate actions. Check the selected destination and configuration name before uploading.
| Provider | Setup guide |
|---|---|
| SM.MS / S.EE | Configure |
| Advanced custom | Configure |
| AList | Configure |
| Qiniu | Configure |
| Tencent COS | Configure |
| Upyun | Configure |
| GitHub | Configure |
| Alibaba OSS | Configure |
| Imgur | Configure |
| WebDAV | Configure |
| Local | Configure |
| SFTP | Configure |
| Lsky | Configure |
| S3 / R2 / MinIO | Configure |
| PicList server | Configure |
| Other providers | Configure |
General settings
System settings
Choose the language, appearance, startup mode, launch at login, and tray or mini window behavior.
Configuration and sync
Use backup and sync for application settings and gallery data. Configuration sync, gallery sync, and a secondary upload destination serve different purposes.
Upload settings
Adjust automatic copying, link format, notifications, and naming. Test each destination separately before enabling a secondary uploader.
Advanced settings
Configure the proxy, logs, temporary directory, and HTTP upload server.
Plugin settings
See plugins for installation, enablement, and configuration. Use the script system for lightweight custom processing.
Configuration reference
The configuration reference explains common fields, named configurations, and processing options, with valid JSON examples.