PicFlow

English | 中文

PicFlow is a command-line tool for automating image processing (scaling/compression) and uploading to cloud storage (e.g., Qiniu Cloud). Supports Windows, Linux, and macOS.

Features

🛠️ Core Capabilities

• Image Processing
  • Scaling, format conversion (JPEG/PNG/WebP)
  • Quality compression (based on cwebp and ImageMagick)
• Cloud Storage Integration
  • Supports Qiniu Cloud, AWS S3 (planned)
  • Auto-generates CDN URLs
• Batch Operations
  • Recursively process folders
  • Parallel task acceleration

🚀 Efficiency

• Config-Driven: Manage cloud keys and parameters via YAML
• Cross-Platform: Run the same command on Windows/Linux/macOS

Installation

Prerequisites

• Python 3.8+
• External Tools (auto-detected):
  • ImageMagick (scaling)
  • cwebp (WebP compression)
  • qshell (Qiniu upload)

Install PicFlow

pip install picflow

Quick Start

1. Configure Qiniu

Create config file ~/.picflow/config.yaml：

storage:
  qiniu:
    access_key: "YOUR_ACCESS_KEY"
    secret_key: "YOUR_SECRET_KEY"
    bucket: "YOUR_BUCKET_NAME"
    domain: "https://cdn.example.com"  # CDN domain

2. Process & Upload Images

# Compress to WebP and upload
picflow process --format webp --quality 85 ~/images/photo.jpg

# Process entire folder recursively
picflow batch ~/gallery --scale 50% --output ~/compressed_gallery

Advanced Configuration

Custom Processing

processing:
  default_quality: 90
  formats:
    webp:
      method: 6  # Compression method level
    jpeg:
      progressive: true  # Progressive JPEG

CLI Options

# Show help
picflow --help

# Override quality parameters in configuration
picflow process input.png --quality 75 --format jpeg

Contributing

Issues and PRs are welcome!

• Code Style: Follow PEP8
• Testing: Add pytest unit tests
• Docs: Update English or Chinese documentation

License

Licensed under the MIT License.