Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Zeal-L/BiliBili-Manga-Downloader
一个好用的哔哩哔哩漫画下载器，拥有图形界面，支持关键词搜索漫画和二维码登入，黑科技下载未解锁章节，多线程下载，多种保存格式，本地漫画管理，一键检查更新！
https://github.com/Zeal-L/BiliBili-Manga-Downloader
bilibili bilibili-download comic-downloader comics crawler downloader gui manga manga-downloader pyside6 python3
Last synced: about 2 months ago
JSON representation
一个好用的哔哩哔哩漫画下载器，拥有图形界面，支持关键词搜索漫画和二维码登入，黑科技下载未解锁章节，多线程下载，多种保存格式，本地漫画管理，一键检查更新！
- Host: GitHub
- URL: https://github.com/Zeal-L/BiliBili-Manga-Downloader
- Owner: Zeal-L
- License: agpl-3.0
- Created: 2023-01-15T00:47:16.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-05T13:38:43.000Z (4 months ago)
- Last Synced: 2024-08-05T15:42:53.382Z (4 months ago)
- Topics: bilibili, bilibili-download, comic-downloader, comics, crawler, downloader, gui, manga, manga-downloader, pyside6, python3
- Language: Python
- Homepage:
- Size: 1.53 MB
- Stars: 830
- Watchers: 3
- Forks: 52
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-bilibili-extra - BiliBili-Manga-Downloader - 一个好用的哔哩哔哩漫画下载器.  (下载工具 / 直播脚本)
README
# 🎉 哔哩哔哩漫画下载器 💖
## 💬 简介
**由于作者某天实在是受不了B漫网页版的观看体验 ~~(时而混入漫画中的广告，无法便捷快速的放大图片，进度栏作死一样的反复横跳挡视线等等...)~~，再加上作者的仓鼠属性 😛**
**因此 将将将~ 🎉 一个好用的哔哩哔哩漫画下载器就此诞生！**
## ✨ 主要功能 / 特性
- **黑科技下载未解锁章节！**
- **提供多种可选的保存格式**
- **支持已购被下架漫画下载**
- **已打包成单个可执行文件，双击即用！**
- **易操作的图形界面！~~(不用再费劲的部署环境跑命令行)~~**
- **无需漫画ID，可直接关键词搜索漫画！并附带搜索词高亮！**
- **可配置的多线程下载，速度拉满！**
- **实现了应对网络波动等情况的异常重试，以及应用了指数级退让来避免在短时间大量重试被拉黑名单**
- **丰富的漫画详情信息，本地漫画管理功能，一键检查更新！**
- **通过正则匹配过滤重复的章节名称内容，以及置换非法字符！**
- **贴心的在保存文件属性中附加了漫画名，章节名以及作者信息，以免单章传播时不知道来源**
- **可视化的多任务下载进度条以及下载速度和剩余时间预计信息！**
- **漫画保存地址和用户Cookie等用户设置的本地缓存，不需要每次重启软件就重新输入！**
- **丰富的错误信息日志，可按照日期滚动储存，不会浪费内存**
- **一键清空用户数据，妈妈再也不用担心我删不干净软件了！~~(bushi)~~**
- **多种主题选择**
## 📸 相关截图
**使用哔站解析**
**使用BiliPlus解析**
**下载进度界面**
## 📝 使用指南
- **下载地址**: [**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` 日志，格式参考已有代码
- 更改 / 新增 的功能说明，理由
- 是否 更改 / 新增 依赖项
## ⚰️ 更新记录
[**详细日志**](UPDATE.md)
## 🍻 联系方式
欢迎进群讨论程序，漫画，资源分享, 提交问题等等
- Q群号：244029317
## 🙈 PS
**做项目不易，求星星！求赞助！如果本项目对你有帮助，请作者喝杯☕吧~**
## 🔒️ 许可协议
- 本项目在遵循 [**GNU Affero General Public License v3.0**](https://www.gnu.org/licenses/agpl-3.0.en.html) 许可协议下进行发布
- 若对代码进行了修改，请务必遵循许可协议的规定进行发布
- **特别提醒，未经合法授权，擅自使用本项目的内容可能涉及侵权行为，我们保留追究相应法律责任的权利**
## ⚠️ 免责申明
- **本软件提供的所有内容，仅可用作学习交流使用，未经版权方以及原作者授权，禁止用于商业目的以及其他用途。请在下载24小时内删除。为尊重版权，请前往资源的原始发布网站观看，支持原创，谢谢**
- 本软件只提供漫画解析，不提供任何个人信息上传、存储到服务器的功能
- 本软件解析得到的所有内容均来自哔哩哔哩漫画官方上传、分享，其版权均归原作者以及哔哩哔哩漫画所有。内容提供者、上传者应对其提供、上传的内容承担全部责任
- 因使用本软件产生的版权问题，软件作者概不负责
- 我们强烈建议您详细阅读并遵守许可协议的规定，以保障您与他人的权益和合法使用
## 🌟 Star History
[](https://star-history.com/#Zeal-L/BiliBili-Manga-Downloader)