BiliBili-Manga-Downloader

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #android #deep-learning #linux #docker #macos #windows #vue #ios #mcp

BiliBili-Manga-Downloader

(★ 1,239)

一个好用的哔哩哔哩漫画下载器，拥有图形界面，支持关键词搜索漫画和二维码登入，黑科技下载未解锁章节，多线程下载，多种保存格式，本地漫画管理，一键检查更新！

BiliBili-Manga-Downloader Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🎉 哔哩哔哩漫画下载器 💖

![GitHub Python version](https://img.shields.io/badge/python-v3.12-blue)
![platform](https://img.shields.io/badge/platform-Windows_|_Macos_|_Linux-blue)
![Scc Count Badge](https://sloc.xyz/github/Zeal-L/BiliBili-Manga-Downloader/)
![GitHub repo size](https://img.shields.io/github/repo-size/Zeal-L/BiliBili-Manga-Downloader)
![GitHub - License](https://img.shields.io/github/license/Zeal-L/BiliBili-Manga-Downloader)

![GitHub closed issues](https://img.shields.io/github/issues-closed/zeal-l/BiliBili-Manga-Downloader)
![GitHub commit activity](https://img.shields.io/github/commit-activity/y/Zeal-L/BiliBili-Manga-Downloader)
![GitHub last commit](https://img.shields.io/github/last-commit/Zeal-L/BiliBili-Manga-Downloader)
![GitHub all releases - Download](https://img.shields.io/github/downloads/Zeal-L/BiliBili-Manga-Downloader/total)

# **由于叔叔现在全面收紧后台api，本项目的主要功能已经失效，暂时不会更新了，感谢大家长期以来的支持~**

## 🍻 联系方式

欢迎进群讨论程序，漫画，资源分享, 提交问题等等

- Q群号：642496134

## 💬 简介

**由于作者某天实在是受不了B漫网页版的观看体验 ~~(时而混入漫画中的广告，无法便捷快速的放大图片，进度栏作死一样的反复横跳挡视线等等...)~~，再加上作者的仓鼠属性 😛**

**因此 将将将~ 🎉 一个好用的哔哩哔哩漫画下载器就此诞生！**

## ✨ 主要功能 / 特性

- **黑科技下载未解锁章节！**
- **提供多种可选的保存格式**
- **支持已购被下架漫画下载**
- **已打包成单个可执行文件，双击即用！**
- **易操作的图形界面！~~(不用再费劲的部署环境跑命令行)~~**
- **无需漫画ID，可直接关键词搜索漫画！并附带搜索词高亮！**
- **可配置的多线程下载，速度拉满！**
- **实现了应对网络波动等情况的异常重试，以及应用了指数级退让来避免在短时间大量重试被拉黑名单**
- **丰富的漫画详情信息，本地漫画管理功能，一键检查更新！**
- **通过正则匹配过滤重复的章节名称内容，以及置换非法字符！**
- **贴心的在保存文件属性中附加了漫画名，章节名以及作者信息，以免单章传播时不知道来源**
- **可视化的多任务下载进度条以及下载速度和剩余时间预计信息！**
- **漫画保存地址和用户Cookie等用户设置的本地缓存，不需要每次重启软件就重新输入！**
- **丰富的错误信息日志，可按照日期滚动储存，不会浪费内存**
- **一键清空用户数据，妈妈再也不用担心我删不干净软件了！~~(bushi)~~**
- **多种主题选择**

## 📸 相关截图

**使用哔站解析**
<div align=center>
<img src="https://github.com/Zeal-L/BiliBili-Manga-Downloader/assets/72005386/5c39fef2-f511-4545-968f-0b4e4ffad110" width=90%>
</div>

**使用BiliPlus解析**
<div align=center>
<img src="https://github.com/Zeal-L/BiliBili-Manga-Downloader/assets/72005386/158a0b8f-f9db-464d-82e2-391dc3a441d9" width=90%>
</div>

**下载进度界面**
<div align=center>
<img src="https://github.com/Zeal-L/BiliBili-Manga-Downloader/assets/72005386/9e12a306-9c91-49e7-8c26-6f39f0c225ec" width=90%>
</div>

## 📝 使用指南
- **下载地址**: [**Releases**](https://github.com/Zeal-L/BiliBili-Manga-Downloader/releases)

- **本软件有两种下载解析方法：**
  - **B站解析**
    - 只能下载免费章节和用户已解锁的章节
    - **首先获得你的Cookie**
      - 方法一 - B漫手机客户端扫码登入
      - 方法二 - 手动获取Cookie:
      1. 以谷歌浏览器为例，打开B漫首页并且登入
      2. 点击 `F12` 打开开发者工具
      3. 点击 `应用` 标签
      4. 在边栏中找到 `Cookie` ，点击 `https://manga.bilibili.com`
      5. 在右侧的详情中找到 `SESSDATA`，复制 `值` 粘贴到程序设置选项中的 `我的Cookie` ，回车确认
      6. 如果提示 `Cookie有效！` 那么就成功了！
      7. 否则请再次确认上述步骤，检查是否正确复制内容不含空格，还有疑问的话欢迎联系作者或提 `Issues`
  - **BiliPlus解析**
    - 利用 [biliplus](https://www.biliplus.com/) 提供的 [ComicWebReader](https://www.biliplus.com/manga/) 在线漫画平台的api来尝试获取更多的可下载章节
    - 该网站现有 4w+ 已关联 `Bilibili` 帐号的访客，也就是说很有概率你想看的漫画已经有人购买了，所以可以尝试一下
    - **特别提示: 毕竟是要提供 Cookie 给第三方网站托管，因此可能会有潜在的安全风险。敏感人群请不要使用自己主账号的 Cookie**
    - `BiliPlus` 的 `Cookie` 获取方法跟上述类似，在 [ComicWebReader](https://www.biliplus.com/manga/) 登入后在开发者工具中找到 `Cookie` 后，将其整个复制并粘贴到程序设置选项中的 `BiliPlus Cookie` 即可

- **兼容性：支持Windows、MacOS与Linux平台，发现问题的欢迎提Issues**
- **搜索 / 选择章节 / 下载 的功能介绍我想已经不言而喻了，这就是图形化界面的好处！**
- **值得注意的是：本软件不支持断点续传和下载任务缓存的功能 ~~(毕竟一章漫画太小了，好像也没什么必要，断了不如重下)~~，所以请确保不要在下载中途关闭！**
- **程序缓存和日志历史文件存在 `C:\Users\AppData\Roaming\BiliBili-Manga-Downloader\` 目录下，可以通过"清空用户数据"功能一键删除**
- **如果想用"本地库存"功能，需要注意的是：下载好的漫画章节名以及保存的 `元数据.json` 都不能更改，否则将会无法正确读取漫画数据**
- **已购被下架的漫画虽然不能通过关键词搜索到，但是可以通过漫画ID直接访问，如果你购买过那么就可以成功下载**

## 💕 友情推荐

**🔥 下面我要隆重的推荐一款搭配本软件使用的本地漫画浏览器 ~~(可以说就是为了这点儿醋 我才包的这顿饺子)~~**

- **NeeView** 是一款 Windows 下开源的图片浏览器，其特色是可以像翻书一样同时浏览两张照片，还支持压缩包看图、鼠标手势、触摸操作、多线程和超前查看、支持 PDF / 视频。 原生支持中文
- 下载地址: [**Microsoft Store**](https://www.microsoft.com/en-us/p/neeview/9p24z53hc1jr)
- 上面是官方介绍，要我说优势就下面几点
  - 自动切页，双页浏览
  - 左右或者右左的阅读顺序一键切换
  - 鼠标左键长摁放大，自由移动放大聚焦点，滚轮调整放大倍数， 这点超爽的好嘛，吊打所有网页浏览体验 ~~(尤其是某些地方需要放大好好品鉴的时候，嗯嗯，我说的就是背景人物！)~~
  - 优秀的资源浏览器以及简明的操作逻辑和界面
  - 总之是电脑端看漫画的不二之选~
- 唯一的缺点好像就是对条漫不太支持，也有可能是我没找到选项，有知道的小伙伴可以联系我，谢啦~

## 💡 TODO List ~~(在可见的未来...)~~

- 更多开发进度详情请看 [**项目清单表**](https://github.com/users/Zeal-L/projects/2/views/1)
- **PS: 也欢迎小伙伴们多多的在Issues里提意见，不管是Bug还是操作逻辑，界面优化等等作者统统笑纳~**
  - 🟦 缓存更多资源，减少网络请求
  - 🟦 添加我的追漫界面，以及追漫功能
  - 🟦 对于有特典的漫画，提供特典下载界面
- **已解决**
  - ✅ ~~添加二维码扫码登入功能~~
  - ✅ ~~添加不同的界面主题~~
  - ✅ ~~添加检测cookie无效或者过期功能，并且弹窗~~
  - ✅ ~~鼠标移动到漫画封面改变鼠标图标，提示用户可以点击跳转~~
  - ✅ ~~一键检查软件更新功能~~
  - ✅ ~~除pdf以外添加不同的保存选项如 7z 或者 基本的文件夹图片~~
  - ✅ ~~启动程序时多线程加载本地库存，避免用户等待太久~~
  - ✅ ~~给打包好的程序添加版本号版权等属性信息~~

## 🏗️ 本地构建 / 编译

- **首先确保你安装了 Python 3.12 和 git**
- **本项目使用了 poetry 依靠虚拟环境进行依赖项管理，所以不必担心影响自己的本地环境**
- **作者已经贴心的帮后来者们准备好了两个集成脚本~**
- **接下来的操作都在项目的根目录运行命令行指令**
- **构建项目**
  1. 执行 `git clone https://github.com/Zeal-L/BiliBili-Manga-Downloader.git`
  2. 执行 `cd BiliBili-Manga-Downloader/`
  3. 执行 `sh setup.sh` 等待项目构建完成
  4. 执行 `poetry shell` 进入虚拟环境
  5. 执行 `python3 app.py` 即可运行程序
- **打包编译**
  1. 执行 `sh build.sh` 等待项目打包完成
  2. 这一步可能会花费一定时间，中途需要手动确认安全漏洞检查
  3. 打包好的程序会被移动到项目的根目录 "哔哩哔哩漫画下载器.exe"
- **彻底清除项目 ~~(删库跑路)~~**
  1. 执行 `poetry env remove python3`
  2. 执行 `cd .. && rm -rf BiliBili-Manga-Downloader/`

## 🔨 PR 格式

- 请PR到 `develop` 分支
- 遵循项目已有代码的 `python doc` 格式
- 明确的注释信息
- 正确的函数类型声明
- 在可能出错的IO/网络申请等部分都加上 `retry` 装饰器
- 在需要的地方写入 `logger` 日志，格式参考已有代码
- 更改 / 新增 的功能说明，理由
- 是否 更改 / 新增 依赖项

## ⚰️ 更新记录

![Repobeats analytics image](https://repobeats.axiom.co/api/embed/cc62fded834eb06fc9b30cf7ffd54eeb53d700fc.svg "Repobeats analytics image")

[**详细日志**](UPDATE.md)

## 🔒️ 许可协议

- 本项目在遵循 [**GNU Affero General Public License v3.0**](https://www.gnu.org/licenses/agpl-3.0.en.html) 许可协议下进行发布
- 若对代码进行了修改，请务必遵循许可协议的规定进行发布
- **特别提醒，未经合法授权，擅自使用本项目的内容可能涉及侵权行为，我们保留追究相应法律责任的权利**

## ⚠️ 免责申明

- **本软件提供的所有内容，仅可用作学习交流使用，未经版权方以及原作者授权，禁止用于商业目的以及其他用途。请在下载24小时内删除。为尊重版权，请前往资源的原始发布网站观看，支持原创，谢谢**
- 本软件只提供漫画解析，不提供任何个人信息上传、存储到服务器的功能
- 本软件解析得到的所有内容均来自哔哩哔哩漫画官方上传、分享，其版权均归原作者以及哔哩哔哩漫画所有。内容提供者、上传者应对其提供、上传的内容承担全部责任
- 因使用本软件产生的版权问题，软件作者概不负责
- 我们强烈建议您详细阅读并遵守许可协议的规定，以保障您与他人的权益和合法使用

## 🌟 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=Zeal-L/BiliBili-Manga-Downloader&type=Date)](https://star-history.com/#Zeal-L/BiliBili-Manga-Downloader)

BiliBili-Manga-Downloader

BiliBili-Manga-Downloader Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

BiliBili-Manga-Downloader

BiliBili-Manga-Downloader Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README