nhentai-helper

🔞 A user script make it easy for you to download nHentai manga as zip (or cbz), also support some mirror sites. 一个可以让你轻松打包下载 nHentai 本子的用户脚本,并支持一些镜像站

GPL-3.0 License

Stars
482
Committers
1

nHentai 助手

GitHub

支持 TampermonkeyViolentmonkey,不支持也不会支持 Greasemonkey

安装

从 Greasy Fork 安装(由于成人内容,需要登录才能安装)

从 Sleazy Fork 安装(不需要登录)

从 GitHub Pages 安装

主要功能

  • 为 nHentai 增加 zip (cbz) 打包下载方式,下载时必须保持页面处于前台
  • 当你下载了一个之前下载过的同名本子时将会弹出提醒,此时你可以选择不下载
  • 本子列表页相关
    • 支持 pjax,翻页不会中断本子下载
    • 下载队列功能
    • 下载过的本子标题会置灰

设置

在设置面板中,带星号*的设置项需要刷新页面才能生效

  • 下载线程数 如果你觉得下载太慢,可以适当提高线程数,不过你得清楚,挂(一个好一点的)代理才是拯救辣鸡网络的实在方法

  • 在新选项卡打开 本子详情页会默认变为在新选项卡中打开,如果不喜欢就关掉它

  • 压缩文件名 默认是{{japanese}}.zip,可自定义下载下来的压缩文件的文件名,包括扩展名,比如{{english}}.cbz 如果压缩文件名中含有文件名非法字符则会自动被替换成空格,你也可以利用「标题替换」设置进行自定义替换 支持的占位符:

    • {{english}} - 本子英文名
    • {{japanese}} - 本子日文名
    • {{pretty}} - 本子英文简略标题
    • {{id}} - 本子 ID
    • {{pages}} - 本子页数
    • {{artist}} - 作者 tag
      • 最大数量:默认 30 代表不限制,超出将变为“various”,可在设置中修改
      • 分隔符:默认 , ,可在设置中修改
  • 压缩等级 范围为0-90是无压缩,1是最快压缩,9是最好压缩,默认为0 其实对于本子,09压出来的文件大小差别通常不到 1%

  • 文件名长度 图片文件名小于这个长度时会自动补 0,可以避免某些场景下只按字符串排序所导致的排序混乱问题

  • 自动取消下载过的本子 当你下载了一个之前下载过的同名本子时将会自动取消下载,而不是弹出选择对话框

  • 发生错误时自动重试 当错误发生时自动重试,而不是弹出选择对话框

  • 自动显示全部 本子详情页自动帮你点击“Show all”按钮

  • 显示忽略按钮 会显示一个忽略按钮,能让你手动标记或取消标记这个本子为已下载的

  • 右击预览 在本子列表页右击本子可以直接预览本子信息和内容缩略图

  • 用标题判断本子是否下载过 你可以指定用来判断本子是否下载过所使用的标题,如果全不选则可以关闭提醒本子下载过的功能;需要注意 简略 在大部分镜像站是无效的

  • 添加元数据文件 目前支持添加这些元数据文件:

    若添加 ComicInfo.xml 则需要指定标题语言(英语或日语)

进阶设置

  • nHentai 下载节点 可以切换下载 nHentai 图片的节点,仅在 nHentai 有效

  • 自定义下载地址 一般情况下不需要填写这个,除非有特殊需求,或者脚本无法在镜像站上自动获取图片下载地址 提供一个包含以下占位符的 URL:

    • {{mid}} - Media ID
    • {{index}} - 页号
    • {{ext}} - 图片扩展名

    例如你自行找到的图片地址为这样的形式 https://example.com/galleries/123456/1.jpg 那么自定义下载地址通常为 https://example.com/galleries/{{mid}}/{{index}}.{{ext}}

  • 压缩 "streamFiles" 选项 启用这个选项可以减少内存消耗,但可能导致某些压缩软件不支持生成的压缩文件,详见说明

  • 串行模式 启用这个选项可以使下载和压缩变为串行任务以减少内存消耗 如果经常出现 RangeError: Array buffer allocation failed 错误,可以尝试启用它

  • 流式下载 利用 StreamSaver.js 直接下载压缩流来减少内存占用 在 Safari 和 Firefox 上无法使用,且下载速度极慢,因此不推荐启用除非真的有内存消耗问题

  • 阻止控制台清空 只在 nHentai 官方站点可用(需要),当你需要提交控制台日志来定位问题的时候请启用它

  • 标题替换 可以对压缩文件名中的标题进行字符替换,支持正则表达式

其他功能

镜像站支持

该脚本支持部分镜像站,具体见脚本的 @match@include

如脚本没有在你使用的域名上运行,可自行将网址加入 用户匹配(脚本编辑-设置-包括/排除-用户匹配-添加)

并不是所有镜像站都支持,脚本仅支持跟 nHentai 官方站点使用同一套 UI(页面结构、元素类名基本一致)的镜像站,不符合的站点不支持

在镜像站使用时,可能会弹出“一个用户脚本试图访问跨源资源”的提示,请选择“总是允许此域名”或“总是允许全部域名

语言过滤

你可以在导航栏中选择一个语言来过滤本子

100% 视图高度

在线阅读时可开启或关闭,只在第三方镜像站生效,nHentai 官方已经有这个功能了

推荐脚本

Related Projects