Pixiv2Eagle

Save Pixiv artworks to Eagle image management software with one click. Supports multi-page artworks, automatic artist folder creation, and preserves tags and metadata

Install this script ?

Ask a question, post a review, or report the script.

Author

nekoday

Daily installs

Total installs

Ratings

0 0 0

Version

2.3.0

Created

2025-04-23

Updated

2026-02-01

Size

53.2 KB

License

MIT

Applies to

pixiv.net

Pixiv2Eagle

✨ New: Convert Pixiv ugoira to GIF and save to Eagle.

Conversion may take some time; please wait patiently.

A Tampermonkey script for saving Pixiv artworks to Eagle image management software.

Features

🖼️ Save Pixiv artworks to Eagle with one click
📁 Automatically create artist-specific folders
🏷️ Preserve artwork tags and metadata
📄 Support for multi-page artwork saving
🗂️ Option to create subfolder for multi-page artwork
📝 Option to save artwork description to Eagle annotation
⏰ Option to use artwork upload time as the addition date
🔢 Optional strict save ordering (preserve original page order via modification time)
🔍 Option to auto-detect whether the current artwork is already saved and open the saved artwork with one click
🔧 Configurable Pixiv folder ID
🐛 Debug mode support
🧪 (Experimental) Set artist folder names through custom templates

Requirements

Install the Tampermonkey browser extension
Install Eagle image management software
Ensure Eagle software is running

Usage

First-time Setup

Launch Eagle software
Create a folder in Eagle for storing Pixiv artworks
Right-click on the folder in Eagle and select "Copy Link"
On a Pixiv artwork page, click the Tampermonkey icon
Select "Set Pixiv Folder ID" and paste the copied folder link (e.g., http://localhost:41595/folder?id=XXXXXX) or just the folder ID (XXXXXX part)
Click "OK" to save the settings

Daily Use

Make sure Eagle software is running
Visit any Pixiv artwork page (/artworks/xxxxx)
Click the "Save to Eagle" button on the page to save the artwork to the specified folder

Folder ID Setting Rules

If a Pixiv folder ID is set:
- The script will search for or create artist-specific folders under the specified Pixiv folder
- If the specified Pixiv folder cannot be found, an error will be displayed
If the folder ID is cleared:
- The script will search for or create artist-specific folders in the Eagle root directory
- When cleared, a message will appear: "Folder ID has been cleared, artist folders will be created in the root directory by default"

Artist Folder Name Template Configuration Rules

$uid represents the artist ID, $name represents the artist name
By default, the artist name is used as the folder name, corresponding to the template $name
A template example: $uid_$name

Feature Details

Saving Artworks

After clicking the "Save to Eagle" button, the script will automatically:
- Retrieve artwork information (title, artist, tags, etc.)
- Check for/create artist-specific folders
- Download and save the artwork to Eagle
- Preserve artwork information within Eagle

Artist Folders

Each artist will have a dedicated folder created under the configured Pixiv folder
The folder name uses the artist's name
The folder description includes the artist's ID for easier management
Implementation logic:
1. First, check if a dedicated folder for the artist already exists under the Pixiv main folder
2. Identify artist folders through the pid = artistID in the folder description
3. If it doesn't exist, automatically create a new artist folder
4. Newly created folders will automatically be set with the artist's name and a description containing the artist's ID
5. All artworks will be saved in the corresponding artist's dedicated folder

Artwork Subfolders

Manga artworks (illustType = 1) or artworks that contain Pixiv series metadata always live inside a series folder under the artist folder, and each artwork gets its own subfolder named after the title; the folder description stores the Pixiv series URL so you can trace the source quickly.
For other artworks you can control the behavior via the Tampermonkey menu entry 🗂️ 切换：为多页作品创建子文件夹, which cycles through Off (关闭) → Multi-page (多页) → Always (始终):
- Off: Any illustrations go directly into the artist/series folder without creating subfolders.
- Multi-page: only artworks where Pixiv reports pageCount > 1 will get a subfolder before the files are saved.
- Always: every artwork—including single-page illustrations and converted ugoira GIFs—receives a dedicated subfolder.
All files from the same Pixiv artwork (images or GIFs) reside in the same subfolder, keeping Eagle collections aligned with Pixiv series/chapters.

Saved Artwork Detection (optional)

Toggle via the Tampermonkey menu 🔎 切换：自动检测作品保存状态.
Flow: fetch current artwork info → locate the artist folder; if the artwork belongs to a Pixiv series, move into the matching series folder, otherwise stay in the artist folder.
First list items in the current folder to match by artwork link; if no hit, traverse its child folders—when a child folder description equals the artwork ID, it is treated as the saved location.
When a saved item is found, the button text changes to “已保存” and a “🔍” button appears.
Note: A large number of artworks may cause performance issues.

Debug Mode

Debug mode can be enabled/disabled in the Tampermonkey menu
When enabled, detailed information about the saving process will be displayed

Upload Time Setting

The use of upload time feature can be enabled/disabled in the Tampermonkey menu
When this feature is enabled:
- Artworks in Eagle will use the upload time on Pixiv as the addition date
- Since Eagle sorts by addition date in descending order by default, the display order of artworks will be consistent with the artist's upload order
- Suitable for users who want to view artworks in the order they were uploaded by the artist
Disabled by default, meaning the actual save time is used as the addition date

Strict Save Order

Toggle via the Tampermonkey menu 🔢 切换：按照严格排序保存
When enabled:
- The first page keeps its base modification time; each subsequent page adds +1 (millisecond)
- The base time follows the Upload Time setting when enabled; otherwise it uses the actual save time
- Useful for viewing artworks in the original Pixiv page order within Eagle

Precautions

Make sure Eagle software is running before use
Pixiv folder ID needs to be configured correctly
Saving large files or multi-page artworks may take longer, please be patient. Download speed mainly depends on your network environment and Pixiv server response time
Please comply with Pixiv's terms of use and copyright regulations

FAQ

Q: Why doesn't the save button appear?

A: Please ensure:

Eagle software is running
The script is installed correctly
The page is fully loaded

Q: How do I get the folder ID?

A: Right-click on the target folder in Eagle, select "Copy Link", and extract the ID part from the link (link format: http://localhost:41595/folder?id=XXXXXX)

Q: What should I do if saving fails?

A: Please check:

Whether Eagle is running
If the network connection is normal
If the folder ID is configured correctly
Enable debug mode to view detailed information
Check the browser console for error messages

If the problem persists after checking the above steps, feel free to submit an issue on GitHub.

Disclaimer

This software is provided as is, without any express or implied warranties. The author is not responsible for any loss or damage caused by the use of this software. By using this software, you agree to assume all related risks.

This tool is only for conveniently collecting and managing artworks you like. During use, please respect the artists' work, and don't forget to like and bookmark the artworks you enjoy - this is the best support and encouragement for creators!

License

This project is licensed under the MIT License. See the LICENSE file for details.

License Notes

The current version uses the MIT License
The author reserves the right to change the license type in future versions
Released versions will maintain their original licenses