Files
Bilibili-gadget/README.md
T
mckero 8db1d171a0 feat: 重大优化更新 - 修复v14.0并发布Pro版
✨ 新功能:
- 创建bilibili_audio_downloader_pro.py (Pro版) - 全新架构重构
- 添加config.json配置文件支持
- 新增INSTALL.md详细安装指南
- 新增VERSION_COMPARISON.md版本对比说明

🐛 Bug修复 (v14.0):
- 修复中文编码显示问题
- 修复ffmpeg进度条计算不准确
- 改进yt-dlp下载进度解析
- 添加重试机制和超时设置
- 完善错误处理和日志记录

🏗️ Pro版优势:
- 面向对象架构设计,代码更清晰
- 自定义异常类和智能错误恢复
- 准确的进度条显示算法
- 完整的日志系统
- 灵活的配置管理
- 更好的用户体验

📚 文档更新:
- 更新README.md,添加版本对比指引
- 更新requirements.txt依赖列表
- 完善项目文档结构
2025-09-21 12:02:11 +08:00

2.7 KiB

License

🎵 Bilibili-gadget

一个功能丰富的B站工具包,支持音频下载、用户管理、批量操作等功能。

✨ 主要功能

  • 音频下载: 支持下载B站视频音频并转换为MP3格式
  • 多分P支持: 支持多分P视频的批量下载
  • 格式转换: 自动转换音频格式,支持高质量MP3输出
  • 进度显示: 实时显示下载和转换进度
  • 错误重试: 智能重试机制,提高下载成功率
  • Cookie管理: 支持多种Cookie格式导入

🚀 快速开始

环境要求

  • Python 3.7+
  • yt-dlp
  • ffmpeg (用于音频格式转换)

安装依赖

pip install -r requirements.txt

准备Cookies

  1. 在浏览器中登录B站
  2. 复制cookies并保存为 cookies.txt 文件
  3. 支持多种格式:Netscape、JSON、直接复制等

使用方法

推荐使用Pro版 (最新优化版)

python bilibili_audio_downloader_pro.py

或使用v14.0 (功能完整版)

python 14.0bilibili_audio_dl.py

📁 文件结构

├── bilibili_audio_downloader_pro.py   # Pro版 (最新优化版)
├── 14.0bilibili_audio_dl.py           # 功能完整版本
├── 1.0bilibili_audio_dl.py            # 早期版本
├── config.json                        # 配置文件
├── requirements.txt                   # 依赖列表
├── cookies.txt                        # Cookies文件
├── INSTALL.md                         # 详细安装指南
├── VERSION_COMPARISON.md              # 版本对比说明
└── 音频/                              # 默认下载目录

💡 版本选择疑惑? 查看 VERSION_COMPARISON.md 了解详细对比

🔧 配置说明

编辑 config.json 文件可以自定义:

  • 下载路径
  • 音频质量
  • 网络超时
  • 重试次数
  • 日志级别

📝 版本更新

Pro版 (推荐)

  • ✅ 重构代码架构,使用面向对象设计
  • ✅ 改进错误处理和日志记录
  • ✅ 修复ffmpeg进度条不准确问题
  • ✅ 优化Cookie管理
  • ✅ 添加配置文件支持
  • ✅ 改进下载重试机制

v14.0 (已修复)

  • ✅ 修复中文编码问题
  • ✅ 添加重试机制
  • ✅ 改进进度条显示
  • ✅ 增强错误处理

⚠️ 注意事项

  1. 请确保Cookie信息有效且包含必要字段
  2. 需要安装ffmpeg才能进行音频格式转换
  3. 遵守B站相关使用条款
  4. 仅用于个人学习和研究用途

🤝 贡献

欢迎提交Issue和Pull Request来改进项目!

📄 许可证

本项目基于 GPLv3 许可证开源。