bili-dl 1.0.0__py3-none-any.whl

bili_dl-1.0.0.dist-info/METADATA

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: bili-dl
+Version: 1.0.0
+Summary: 一个功能强大的B站视频下载工具，支持最高清晰度下载和自动合并
+Home-page: https://github.com/WavesMan/bili-download
+Author: B站视频下载器
+Author-email: 
+License: MIT License
+Project-URL: Homepage, https://github.com/WavesMan/bili-downloader
+Project-URL: BugTracker, https://github.com/WavesMan/bili-downloader/issues
+Project-URL: Source, https://github.com/WavesMan/bili-downloader
+Keywords: bilibili,video,download,b站,视频下载
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: qrcode>=7.3.1
+Requires-Dist: Pillow>=9.3.0
+Provides-Extra: dev
+Requires-Dist: black>=22.10.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=0.991; extra == "dev"
+Requires-Dist: pytest>=7.2.0; extra == "dev"
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# B站视频下载器 (bili-downloader)
+
+[![PyPI version](https://img.shields.io/pypi/v/bili-dl.svg)](https://pypi.org/project/bili-dl/)
+[![Python versions](https://img.shields.io/pypi/pyversions/bili-dl.svg)](https://pypi.org/project/bili-dl/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+一个功能强大的B站视频下载工具，支持最高清晰度下载和自动合并。
+
+## ✨ 功能特性
+
+- 🎯 **智能清晰度选择**: 自动获取账号权限内的最高清晰度视频
+- 🔐 **多种登录方式**: 支持二维码登录和Cookie登录
+- 🔍 **Cookie状态检查**: 自动验证Cookie可用性，失效时提示重新登录
+- 📦 **自动合并**: 支持DASH格式视频的自动音视频合并
+- 🚀 **多线程下载**: 支持多线程并发下载，提高下载速度
+- 📁 **智能文件管理**: 按BV号自动组织文件结构
+- 📊 **元数据保存**: 自动保存视频信息和下载元数据
+- ⚡ **断点续传**: 支持下载中断后继续下载
+- 🏗️ **模块化架构**: 清晰的命令分离和职责划分
+
+## 📦 安装
+
+### 通过 pip 安装
+
+```bash
+pip install bili-dl
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/WavesMan/bili-download.git
+cd bili-downloader
+pip install -e .
+```
+
+## 🚀 快速开始
+
+### 基本使用
+
+```bash
+# 查看帮助信息
+bili-dl --help
+
+# 查看特定命令帮助
+bili-dl download --help
+bili-dl login --help
+bili-dl status --help
+
+# 下载单个视频（需要先登录）
+bili-dl download BV1A6aRz4EBU
+
+# 指定输出目录
+bili-dl download BV1A6aRz4EBU --output ./my_videos
+
+# 指定清晰度 (80=1080P, 112=1080P+, 120=4K)
+bili-dl download BV1A6aRz4EBU --quality 112
+
+# 禁用自动合并
+bili-dl download BV1A6aRz4EBU --no-merge
+
+# 登录B站账号
+bili-dl login
+
+# 检查登录状态
+bili-dl status
+```
+
+### 配置说明
+
+首次运行会自动创建配置文件 `~/.bili-downloader/config.json`，您可以编辑此文件来自定义设置：
+
+```json
+{
+  "user": {
+    "cookies": {},
+    "session_data": {}
+  },
+  "download": {
+    "output_dir": "downloads",
+    "timeout": 30,
+    "retry_times": 3,
+    "chunk_size": 8192
+  },
+  "ffmpeg": {
+    "auto_merge": true,
+    "ffmpeg_path": "ffmpeg"
+  },
+  "debug": {
+    "enable_logging": false,
+    "log_level": "INFO"
+  }
+}
+```
+
+## 🔧 高级用法
+
+### 作为Python模块使用
+
+```python
+from bili_downloader.commands import handle_download_command, handle_login_command
+from bili_downloader.services.login_manager import login_manager
+
+# 初始化配置
+from bili_downloader.config.config_manager import init_config
+init_config()
+
+# 登录
+login_manager.init_login()
+
+# 下载视频
+success = handle_download_command("BV1A6aRz4EBU", output_dir="./videos")
+if success:
+    print("下载成功！")
+```
+
+### 批量下载
+
+```python
+from bili_downloader.commands import handle_download_command
+
+video_list = [
+    "BV1A6aRz4EBU",
+    "BV1B6bRz5FCV", 
+    "BV1C7cSx6GDW"
+]
+
+for bvid in video_list:
+    handle_download_command(bvid)
+```
+
+## 📁 文件结构
+
+下载完成后，文件会按以下结构组织：
+
+```
+downloads/
+└── BV1A6aRz4EBU/
+    ├── 视频标题_video.m4s      # 视频流文件
+    ├── 视频标题_audio.m4s      # 音频流文件
+    ├── 视频标题.mp4           # 最终合并的视频文件
+    └── metadata.json          # 视频元数据信息
+```
+
+项目代码结构：
+
+```
+bili-downloader/
+├── commands/                 # 命令处理模块
+│   ├── download_command.py   # 下载命令处理
+│   ├── login_command.py      # 登录命令处理
+│   └── status_command.py     # 状态检查命令
+├── modules/                  # 核心功能模块
+│   ├── login_manager.py      # 登录管理
+│   ├── video_info.py         # 视频信息获取
+│   ├── stream_downloader.py  # 流下载器
+│   └── ffmpeg_integration.py # FFmpeg集成
+├── services/                 # 服务层
+│   └── __init__.py
+├── utils/                    # 工具函数
+│   └── common_utils.py
+├── config/                   # 配置管理
+│   └── config_manager.py
+└── main.py                   # 主入口点
+```
+
+## ⚙️ 依赖要求
+
+- Python 3.7+
+- requests >= 2.28.0
+- qrcode >= 7.3.1
+- Pillow >= 9.3.0
+- ffmpeg (用于视频合并，可选但推荐)
+
+## 🔍 常见问题
+
+### Q: 如何安装 ffmpeg？
+
+**Windows:**
+1. 下载 ffmpeg: https://ffmpeg.org/download.html
+2. 解压并添加 bin 目录到系统 PATH
+
+**macOS:**
+```bash
+brew install ffmpeg
+```
+
+**Linux (Ubuntu/Debian):**
+```bash
+sudo apt install ffmpeg
+```
+
+### Q: 登录失败怎么办？
+
+使用 login 命令重新登录：
+```bash
+bili-dl login
+```
+
+### Q: Cookie失效怎么办？
+
+程序会自动检测Cookie状态，如果失效会在下载时提示重新登录。
+
+### Q: 下载速度慢怎么办？
+
+可以尝试：
+1. 检查网络连接
+2. 使用更好的网络环境
+3. 调整配置中的超时和重试参数
+
+## 📄 许可证
+
+本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## ⚠️ 免责声明
+
+本项目仅用于学习和研究目的，请勿用于商业用途。下载的视频请遵守相关法律法规和B站用户协议。

bili_dl-1.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+main.py,sha256=YcX98BLpByL7m0osEO4yKgeu5Ee-OIRHXVsFaO7bbKs,3579
+bili_dl-1.0.0.dist-info/licenses/LICENSE,sha256=vWcRnXHr_5GmXiWCFQztXd-j0KDZRORLfhAzuaSBn9U,1088
+config/config.json,sha256=T4yCazds-_cDDrBZrpy-cTs6PdUzi4e1dEPFAFr8J5Q,994
+config/config_manager.py,sha256=6j2KxWZyJ9BJ8ip_1cq9lZbrzML3QKxdq4zx61GJKbk,5336
+modules/ffmpeg_integration.py,sha256=NA-3m8dP8USpB3_q8sNdDmuFLmtLtvvMyMdS6PgLpl4,8832
+modules/login_manager.py,sha256=tdtLzXwP4iAncrtQUM7mQgPWnZzRreD2xmHqta9E78w,10317
+modules/stream_downloader.py,sha256=zi96yNHWUbfa8NwiIXYUogbmHyAGZTQDjoA1U0V-R7k,9164
+modules/video_info.py,sha256=zxoQtHxdX4SwFvDAYo-OgL0vHNUOWVdCTpEidqiY8CU,12770
+utils/common_utils.py,sha256=VTs2mNc5hswlSR8AxucLvzZCC7XeHJ1zIMQ8oBlIwyE,6635
+bili_dl-1.0.0.dist-info/METADATA,sha256=uiMY1wywHyQv_AXS5IQagLt0LJJTp5eVXqoi2M6NCiE,7039
+bili_dl-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+bili_dl-1.0.0.dist-info/entry_points.txt,sha256=-gPMZPZ_lKR0X9M_JJJpo5bSSCa0YsyNUB4ljJrE220,38
+bili_dl-1.0.0.dist-info/top_level.txt,sha256=st8kmeGbQ-50d_WZ4f3vn7SpHlQeBgSU2BYiJaCJYLc,26
+bili_dl-1.0.0.dist-info/RECORD,,

bili_dl-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bili_dl-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bili-dl = main:main

bili_dl-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2025] [WavesMan]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bili_dl-1.0.0.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+config
+main
+modules
+utils

config/config.json

@@ -0,0 +1,34 @@
+{
+  "user": {
+    "username": "",
+    "password": "",
+    "cookies": {
+      "SESSDATA": "0fc465a8%2C1772935699%2Cbd375%2A92CjBRcIhnkNlH1YLbAV8BuxHVYDMZC7yPPPKJQsc2hkBJUe7TkgDMsCtlDOos28Pi-PgSVkxIX0RkUWQtU3FnWHdjLWJEd3dPMUU1M3VKWk05Mlp1V1dFdVJjdlpvXzFUMlBfclVVOG9OSW94YTRRdnl3REtQS3dSUHlrUGxrbmRYZ1hZaW9fbGNBIIEC",
+      "bili_jct": "dca7ec9993c6431dd525d57ce54f5b8b",
+      "DedeUserID": "478191001"
+    },
+    "login_method": "qrcode"
+  },
+  "download": {
+    "output_dir": "downloads",
+    "quality": "auto",
+    "format": "mp4",
+    "threads": 4,
+    "retry_times": 3,
+    "timeout": 30
+  },
+  "ffmpeg": {
+    "path": "auto",
+    "auto_merge": true,
+    "delete_temp_files": true
+  },
+  "network": {
+    "proxy": "",
+    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
+  },
+  "debug": {
+    "enable_logging": false,
+    "log_level": "INFO",
+    "save_response": false
+  }
+}

config/config_manager.py

@@ -0,0 +1,154 @@
+import json
+import os
+from typing import Dict, Any, Optional
+import logging
+
+class ConfigManager:
+    def __init__(self, config_path: str = "config/config.json"):
+        self.config_path = config_path
+        self.config: Dict[str, Any] = {}
+        self.logger = logging.getLogger(__name__)
+        
+    def load_config(self) -> bool:
+        """加载配置文件"""
+        try:
+            if not os.path.exists(self.config_path):
+                self.logger.warning(f"配置文件不存在: {self.config_path}")
+                return False
+                
+            with open(self.config_path, 'r', encoding='utf-8') as f:
+                self.config = json.load(f)
+            self.logger.info("配置文件加载成功")
+            return True
+        except json.JSONDecodeError as e:
+            self.logger.error(f"配置文件格式错误: {e}")
+            return False
+        except Exception as e:
+            self.logger.error(f"加载配置文件失败: {e}")
+            return False
+    
+    def save_config(self) -> bool:
+        """保存配置文件"""
+        try:
+            os.makedirs(os.path.dirname(self.config_path), exist_ok=True)
+            with open(self.config_path, 'w', encoding='utf-8') as f:
+                json.dump(self.config, f, indent=2, ensure_ascii=False)
+            self.logger.info("配置文件保存成功")
+            return True
+        except Exception as e:
+            self.logger.error(f"保存配置文件失败: {e}")
+            return False
+    
+    def get(self, key: str, default: Any = None) -> Any:
+        """获取配置项"""
+        keys = key.split('.')
+        value = self.config
+        
+        for k in keys:
+            if isinstance(value, dict) and k in value:
+                value = value[k]
+            else:
+                return default
+        
+        return value
+    
+    def set(self, key: str, value: Any) -> bool:
+        """设置配置项"""
+        keys = key.split('.')
+        config_ref = self.config
+        
+        # 遍历到最后一个键之前
+        for k in keys[:-1]:
+            if k not in config_ref or not isinstance(config_ref[k], dict):
+                config_ref[k] = {}
+            config_ref = config_ref[k]
+        
+        # 设置最后一个键的值
+        config_ref[keys[-1]] = value
+        return self.save_config()
+    
+    def get_user_cookies(self) -> Dict[str, str]:
+        """获取用户Cookie"""
+        cookies = self.get('user.cookies', {})
+        return {k: v for k, v in cookies.items() if v}  # 过滤空值
+    
+    def update_user_cookies(self, cookies: Dict[str, str]) -> bool:
+        """更新用户Cookie"""
+        current_cookies = self.get('user.cookies', {})
+        current_cookies.update(cookies)
+        return self.set('user.cookies', current_cookies)
+    
+    def get_download_config(self) -> Dict[str, Any]:
+        """获取下载配置"""
+        return self.get('download', {})
+    
+    def get_ffmpeg_config(self) -> Dict[str, Any]:
+        """获取ffmpeg配置"""
+        return self.get('ffmpeg', {})
+    
+    def get_network_config(self) -> Dict[str, Any]:
+        """获取网络配置"""
+        return self.get('network', {})
+    
+    def create_default_config(self) -> bool:
+        """创建默认配置文件"""
+        default_config = {
+            "user": {
+                "username": "",
+                "password": "",
+                "cookies": {
+                    "SESSDATA": "",
+                    "bili_jct": "",
+                    "DedeUserID": "",
+                    "buvid3": ""
+                },
+                "login_method": "qrcode"
+            },
+            "download": {
+                "output_dir": "downloads",
+                "quality": "auto",
+                "format": "mp4",
+                "threads": 4,
+                "retry_times": 3,
+                "timeout": 30
+            },
+            "ffmpeg": {
+                "path": "auto",
+                "auto_merge": true,
+                "delete_temp_files": true
+            },
+            "network": {
+                "proxy": "",
+                "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
+            },
+            "debug": {
+                "enable_logging": false,
+                "log_level": "INFO",
+                "save_response": false
+            }
+        }
+        
+        self.config = default_config
+        return self.save_config()
+
+# 全局配置实例
+config_manager = ConfigManager()
+
+def init_config() -> bool:
+    """初始化配置"""
+    if not os.path.exists(config_manager.config_path):
+        return config_manager.create_default_config()
+    return config_manager.load_config()
+
+# 配置访问快捷方式
+def get_config(key: str, default: Any = None) -> Any:
+    return config_manager.get(key, default)
+
+def set_config(key: str, value: Any) -> bool:
+    return config_manager.set(key, value)
+
+def get_user_cookies() -> Dict[str, str]:
+    return config_manager.get_user_cookies()
+
+def update_user_cookies(cookies: Dict[str, str]) -> bool:
+    return config_manager.update_user_cookies(cookies)

main.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+B站视频下载器 - 模块化重构版本
+功能：通过JSON配置控制登录 -> 获取最高清晰度视频 -> 自动合并DASH格式视频
+"""
+
+import argparse
+import logging
+import sys
+import os
+
+# 添加项目根目录到Python路径
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from config.config_manager import init_config
+from utils.common_utils import setup_logging
+from commands import handle_download_command, handle_login_command, handle_status_command
+
+def setup_argparse() -> argparse.ArgumentParser:
+    """设置命令行参数解析"""
+    parser = argparse.ArgumentParser(description='B站视频下载器')
+    subparsers = parser.add_subparsers(dest='command', help='子命令', required=True)
+    
+    # download 子命令
+    dl_parser = subparsers.add_parser('download', help='下载视频')
+    dl_parser.add_argument('video_id', help='B站视频BV号或AV号，例如：BV1Ab411C7Q9 或 av123456789')
+    dl_parser.add_argument('--output', '-o', default=None, help='输出目录')
+    dl_parser.add_argument('--quality', '-q', type=int, default=None, help='指定清晰度（可选）')
+    dl_parser.add_argument('--no-merge', action='store_true', help='不自动合并DASH视频')
+    dl_parser.add_argument('--no-login', '--guest', action='store_true', 
+                          help='忽略登录状态，使用游客模式下载（可能只能下载较低清晰度）')
+    dl_parser.add_argument('--config', '-c', default='config/config.json', help='配置文件路径')
+    dl_parser.add_argument('--debug', '-d', action='store_true', help='启用调试模式')
+    
+    # login 子命令
+    login_parser = subparsers.add_parser('login', help='登录B站账号')
+    login_parser.add_argument('--force', '-f', action='store_true', help='强制重新登录')
+    login_parser.add_argument('--config', '-c', default='config/config.json', help='配置文件路径')
+    login_parser.add_argument('--debug', '-d', action='store_true', help='启用调试模式')
+    
+    # status 子命令
+    status_parser = subparsers.add_parser('status', help='检查登录状态')
+    status_parser.add_argument('--config', '-c', default='config/config.json', help='配置文件路径')
+    status_parser.add_argument('--debug', '-d', action='store_true', help='启用调试模式')
+    
+    return parser
+
+def initialize_system(config_path: str, debug: bool = False) -> bool:
+    """初始化系统配置"""
+    try:
+        # 设置日志
+        log_level = "DEBUG" if debug else "INFO"
+        setup_logging(level=log_level)
+        
+        # 初始化配置
+        if not init_config():
+            print("配置文件初始化失败")
+            return False
+        
+        print("系统初始化完成")
+        return True
+        
+    except Exception as e:
+        print(f"系统初始化失败: {e}")
+        return False
+
+
+def main():
+    """主函数"""
+    parser = setup_argparse()
+    args = parser.parse_args()
+    
+    # 初始化系统
+    if not initialize_system(args.config, args.debug):
+        return 1
+    
+    # 处理子命令
+    if args.command == 'download':
+        return handle_download_command(args)
+    elif args.command == 'login':
+        return handle_login_command(args)
+    elif args.command == 'status':
+        return handle_status_command(args)
+    else:
+        parser.print_help()
+        return 1
+
+if __name__ == "__main__":
+    sys.exit(main())