mckero
8db1d171a0
✨ 新功能: - 创建bilibili_audio_downloader_pro.py (Pro版) - 全新架构重构 - 添加config.json配置文件支持 - 新增INSTALL.md详细安装指南 - 新增VERSION_COMPARISON.md版本对比说明 🐛 Bug修复 (v14.0): - 修复中文编码显示问题 - 修复ffmpeg进度条计算不准确 - 改进yt-dlp下载进度解析 - 添加重试机制和超时设置 - 完善错误处理和日志记录 🏗️ Pro版优势: - 面向对象架构设计，代码更清晰 - 自定义异常类和智能错误恢复 - 准确的进度条显示算法 - 完整的日志系统 - 灵活的配置管理 - 更好的用户体验 📚 文档更新: - 更新README.md，添加版本对比指引 - 更新requirements.txt依赖列表 - 完善项目文档结构
104 lines
2.7 KiB
Markdown
104 lines
2.7 KiB
Markdown
[](https://www.gnu.org/licenses/gpl-3.0)
|
|
|
|
# 🎵 Bilibili-gadget
|
|
|
|
一个功能丰富的B站工具包，支持音频下载、用户管理、批量操作等功能。
|
|
|
|
## ✨ 主要功能
|
|
|
|
- **音频下载**: 支持下载B站视频音频并转换为MP3格式
|
|
- **多分P支持**: 支持多分P视频的批量下载
|
|
- **格式转换**: 自动转换音频格式，支持高质量MP3输出
|
|
- **进度显示**: 实时显示下载和转换进度
|
|
- **错误重试**: 智能重试机制，提高下载成功率
|
|
- **Cookie管理**: 支持多种Cookie格式导入
|
|
|
|
## 🚀 快速开始
|
|
|
|
### 环境要求
|
|
|
|
- Python 3.7+
|
|
- yt-dlp
|
|
- ffmpeg (用于音频格式转换)
|
|
|
|
### 安装依赖
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### 准备Cookies
|
|
|
|
1. 在浏览器中登录B站
|
|
2. 复制cookies并保存为 `cookies.txt` 文件
|
|
3. 支持多种格式：Netscape、JSON、直接复制等
|
|
|
|
### 使用方法
|
|
|
|
#### 推荐使用Pro版 (最新优化版)
|
|
```bash
|
|
python bilibili_audio_downloader_pro.py
|
|
```
|
|
|
|
#### 或使用v14.0 (功能完整版)
|
|
```bash
|
|
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](VERSION_COMPARISON.md) 了解详细对比
|
|
|
|
## 🔧 配置说明
|
|
|
|
编辑 `config.json` 文件可以自定义：
|
|
|
|
- 下载路径
|
|
- 音频质量
|
|
- 网络超时
|
|
- 重试次数
|
|
- 日志级别
|
|
|
|
## 📝 版本更新
|
|
|
|
### Pro版 (推荐)
|
|
- ✅ 重构代码架构，使用面向对象设计
|
|
- ✅ 改进错误处理和日志记录
|
|
- ✅ 修复ffmpeg进度条不准确问题
|
|
- ✅ 优化Cookie管理
|
|
- ✅ 添加配置文件支持
|
|
- ✅ 改进下载重试机制
|
|
|
|
### v14.0 (已修复)
|
|
- ✅ 修复中文编码问题
|
|
- ✅ 添加重试机制
|
|
- ✅ 改进进度条显示
|
|
- ✅ 增强错误处理
|
|
|
|
## ⚠️ 注意事项
|
|
|
|
1. 请确保Cookie信息有效且包含必要字段
|
|
2. 需要安装ffmpeg才能进行音频格式转换
|
|
3. 遵守B站相关使用条款
|
|
4. 仅用于个人学习和研究用途
|
|
|
|
## 🤝 贡献
|
|
|
|
欢迎提交Issue和Pull Request来改进项目！
|
|
|
|
## 📄 许可证
|
|
|
|
本项目基于 GPLv3 许可证开源。
|