/pxder

🖼 Download illusts from pixiv.net P站插画批量下载器

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

pixiv downloader

运行示例

简单写下说明(主要针对 Windows 用户)

准备

首先你需要先安装 Node.js

Windows

打开官网 => 下载右边的“最新发布版” => 安装一路确定

Linux

# Ubuntu
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

# Debian
curl -sL https://deb.nodesource.com/setup_10.x | bash -
apt-get install -y nodejs

# Centos
curl -sL https://rpm.nodesource.com/setup_10.x | bash -
yum install nodejs -y

安装/更新/卸载

打开“命令提示符”或者“Powershell”,执行下面的命令,即可安装或者更新(注:后续命令皆为在此执行)

npm i -g pxder

如需卸载,执行

npm uninstall -g pxder

配置

登录

pxder --login

然后会让你输入用户名密码,登录成功一次后以后如果没有出什么bug则无需再次登录

注:pxder 仅会在计算机上储存 refreshAccessToken,而不会储存您的帐号密码

如果要登出

pxder --logout

设置

进入 Pxder 的设置界面

pxder --setting

有五项设置,按下数字键选择一项进行设置,然后按照要求输入之后回车即可

[1] Download path	# 下载目录,必须设置
[2] Download thread	# 下载线程数
[3] Download timeout	# 下载超时
[4] Auto rename		# 自动重命名(文件夹)
[5] Proxy		# 使用代理
  • 下载目录
    请注意相对路径与绝对路径的区别,不过不用担心,输入完路径后会显示绝对路径以方便你检查
    目录无需手动建立,下载图片的时候会自动建立

  • 下载线程数
    即同时下载的图片数,默认为5,最小为1,最大为10,不推荐使用过多的线程
    下载图片时最左侧的一列实际上就是线程编号

  • 下载超时及重试
    如果这么多秒之后一张图还没被下载完则算作超时,超时后会自动重试,默认值为30
    下载图片时如果线程编号是黄色底的就代表此次是重试
    重试超过10次则视作下载失败

  • 自动重命名
    开启了以后,例如这个画师原来叫abc,今天你再次去下载(更新)他的画作,但是他改名叫def了,那么程序会自动帮你重命名画师文件夹

  • 使用代理
    支持使用 HTTP 或 SOCKS 代理,即可以使用小飞机
    输入格式为<协议>://[用户名:密码@]<IP>:<端口>,例如:

    • http://user:passwd@127.0.0.1:1080
    • socks://127.0.0.1:1080(如果你使用小飞机则直接填这个,除非你改过本地端口)

    如果输入空行则关闭代理

注:配置文件存放路径由 appdata-path 决定,位于该路径下的pxder文件夹内

运行机制

  • 会将同一画师的作品下载在(UID)画师名格式的文件夹内,图片命名格式为(PID)作品名
    并且,画师名会自动删除名字中@(包含半角&全角)符号及以后的文字(因为这些基本上都是画师的摊位信息之类的与名字无关的信息)
  • 文件(夹)名均会过滤掉所有 Windows 和 Linux 中不能或不推荐做文件名的符号
  • 动图下下来会是所有帧的压缩包
  • 下载时会忽略掉已经下载的插画,但是如果你下载到一半退出,会在temp文件夹内残留未下载完整的坏图片,你可以自行删除,或者当你再次开始同一画师的下载并完成时也会自动被删除
  • 下载超时或网络错误会自动重试,重试上限为10次

正式使用

小知识:在命令行中按下Ctrl + C可终止执行

(1) 下载或更新某画师的所有插画作品

使用-u--uid参数,后跟画师的 UID,可单个可多个,如果多个则用英文半角逗号隔开

pxder -u uid1,uid2,uid3,...

例如

pxder -u 5899479,724607,11597411

(2) 下载或更新你关注的所有画师的所有插画作品

该操作同时也会更新已下载的关注画师的作品,并且效率远高于 (3),比较推荐使用

会自动排除 pixiv事務局 (uid=11)

由于收集关注信息需时较久,因此特地针对该功能做了信息缓存:如果你在下载中途退出,那么下次使用该功能时并不需要重新收集,而是利用上次的缓存立即继续下载。

  • 公开关注与私密关注的缓存是分开的,互不干扰
  • 如果你需要强制重新收集画师信息(忽略上次的缓存),请在运行命令时加入--force参数

公开关注的画师

pxder -f
#
pxder --follow

私密关注的画师

pxder -F
#
pxder --follow--private

(3) 更新已下载的画师的画作

会对下载目录中检测到的所有下载过的画师的插画进行增量更新下载

与 (2) 的区别是可以更新你使用 (1) 下载了的但是未关注的画师的插画,但是效率远低于 (2)

pxder -U
#
pxder --update

(4) 下载或更新你的收藏中的插画作品

公开收藏

插画会被下载至[bookmark] Public文件夹中

pxder -b
#
pxder --bookmark

私密收藏

插画会被下载至[bookmark] Private文件夹中

pxder -B
#
pxder --bookmark--private

(5) 根据指定 PID 下载插画

插画会被下载至PID文件夹中

pxder -p pid1,pid2,pid3,...

例如

pxder -p 70593670,70594912,70595516