EN_README.md

pixiv_pictures_manager

English | 简体中文

Have you downloaded a bunch of pictures from pixiv but can't find the ones you want due to the sheer volume? This tool can help you manage these pictures, making it easier to find and use them.

Only supports pictures downloaded using Powerful Pixiv Downloader.

Table of Contents

• pixiv_pictures_manager
  • Table of Contents
  • Project Background
  • Features
    • 1. Tag Search
    • 2. Tag Completion
    • 3. Picture Filtering
    • 4. Picture Sorting
  • Usage
    • Environment Requirements
    • Installation Steps
    • Usage Tutorial
      • 1. Scan Your Picture Folder
      • 2. Use Tag Search
      • 3. Filter Pictures
      • 4. Sort Pictures
  • Future Plans
  • User Feedback
  • Changelog
  • License
  • Related Links

Project Background

After downloading a large number of pictures from Pixiv, managing and finding specific pictures becomes very difficult. This tool aims to help users quickly find desired pictures through tags, filtering, and sorting features to improve picture management efficiency.

Features

1. Tag Search

• Search pictures using tags with multi-tag support.

2. Tag Completion

• Automatically complete picture tags based on existing tags and tag relationships in the tag library.

3. Picture Filtering

• Filter pictures by file type or resolution.

4. Picture Sorting

• Sort pictures by file size, resolution, aspect ratio, and other attributes.

Usage

Currently in development. Only basic features are implemented. To try the tool:

Environment Requirements

• Python 3.9+ (Developed on Python 3.11.10)
• Dependencies listed in requirements.txt

Installation Steps

1. Clone repository:

git clone https://github.com/djasoid/pixiv_pictures_manager.git

2. Enter directory:

cd pixiv_pictures_manager

3. Install dependencies:

pip install -r requirements.txt

4. Run the program:

python src/start_picture_manager.py

Usage Tutorial

1. Scan Your Picture Folder

Click File → Add New Pictures and select your folder. The program will:

• Auto-detect PID and image numbers in filenames (supports {pid}_{num}.ext and {pid}.ext formats)
• Parse metadata files (.txt/.csv) from Powerful Pixiv Downloader
• Complete tags using the tag library

2. Use Tag Search

• Click sidebar tags to include (green)
• Double-click tags to exclude (red)
• Multi-tag search supported
• Shows untagged pictures when no tags selected

3. Filter Pictures

• Filter by file type (JPG/PNG/GIF)
• Resolution filtering:
  • <1000: Width/Height < 1000px
  • >1000: Width/Height > 1000px
  • 1000-2000: Between 1000px-2000px

4. Sort Pictures

• Sort by aspect ratio (closest matches first)
• Sort by PID
• More sorting options in development

Future Plans

• Enhanced sorting features
• Picture favorites system
• Image preview functionality

User Feedback

Submit issues via GitHub Issues.

Changelog

• 2025-02-01: Initial beta release with core features

License

GPLv3 - See LICENSE

Related Links

• Powerful Pixiv Downloader