/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,最大为32
    下载图片时最左侧的一列实际上就是线程编号

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

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

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

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

    如果输入空行则关闭代理

注:配置文件存放路径可通过命令pxder --conf-loca查看

运行机制&特性

  • 会将同一画师的作品下载在(UID)画师名格式的文件夹内,图片命名格式为(PID)作品名
    并且,画师名会自动删除名字中@(包含半角&全角)符号及以后的文字(因为这些基本上都是画师的摊位信息之类的与名字无关的信息)
  • 文件(夹)名均会过滤掉所有 Windows 和 Linux 中不能或不推荐做文件名的符号
  • 动图下下来会是所有帧的压缩包,并且会标注 delay 信息
    • 例如xxx@30ms.zip表示该动图的播放速度为 30ms 一帧
    • 由于获取动图信息需要额外调用API,因此如果动图较多将会使得解析时间较长
  • 下载时会忽略掉已经下载完成的插画
  • 下载超时或网络错误会自动重试,重试上限为10次
    • 如果当某一个线程达到重试上限并且此时有不止一个下载线程处于重试状态,程序将视为暂时出现了网络问题,暂停5分钟后会继续重试
    • 如果只有一个下载线程出现错误,程序将会放弃下载该p并继续运行(因为有出现过确实是因为P站自己的问题而无法下载的例子48948784_p4
  • 抗GFW连接重置攻击,解析时被连接重置会自动重试

正式使用

如果需要终止程序,请在命令行中按下Ctrl + C或者直接关闭命令行窗口

请不要吐槽为什么在 Windows 下Ctrl + C后提示的终止批处理操作吗(Y/N)?不管是 Y 还是 N 都依然会终止,因为 nodejs 捕捉到Ctrl + C就自己终止了,Windows 晚了一步(。

(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

捐赠

支付宝 微信

感谢每一位捐赠者 XD