# dlb

**Repository Path**: byusistudio/dlb

## Basic Information

- **Project Name**: dlb
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-04-17
- **Last Updated**: 2025-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DLB - 多线程下载工具库

[![MIT License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Gitee Stars](https://gitee.com/byusi/dlb/badge/star.svg?theme=white)](https://gitee.com/byusi/dlb)

> 基于 Python 开发的高效多线程下载工具，支持进度显示和智能配置

## 功能特性

- 🚀 **多线程加速**：支持自定义并发线程数 (`-j` 参数)
- 📊 **可视化进度**：使用 Rich 库实现美观的终端进度条
- 🛠 **智能配置**：自动保存用户设置到 `~/.dlb.json`
- 🌍 **多语言支持**：自动适配中英文界面
- 🍪 **Cookie 支持**：可通过配置或命令行设置请求 Cookies
- ⏳ **断点占位**：支持创建占位文件避免重复下载

## 安装方式

### 通过 PyPI 安装 (推荐)
```bash
pip install byusi-dlb
```

### 从 Gitee 仓库安装
```bash
pip install git+https://gitee.com/byusi/dlb.git
```

### 开发版安装
```bash
git clone https://gitee.com/byusi/dlb.git
cd dlb
pip install -e .
```

## 快速开始

### 基础下载
```bash
dlb https://example.com/file1.zip https://example.com/file2.zip
```

### 高级用法
```bash
# 指定输出目录和线程数
dlb -o ./downloads -j 8 https://example.com/large-file.iso

# 设置 Cookie 并保存配置
dlb --cookie "session=abc123" --set-config -j 4

# 批量下载视频文件
dlb $(seq -f "https://video-site.com/video_%03d.mp4" 1 100)
```

## 配置文件
默认配置文件路径：`~/.dlb.json`

```json
{
  "language": "auto",
  "max_workers": 5,
  "max_downloads": 10,
  "cookies": "",
  "placeholder": false,
  "timeout": 30
}
```

## 版权与协议
**Copyright © 2025 ByUsi**  
本项目采用 [MIT 开源协议](LICENSE)，您可以自由地：

- 使用、复制、修改本软件
- 进行再分发和商业使用

## 项目地址
访问 Gitee 仓库获取最新代码：  
[gitee.com/byusi/dlb](https://gitee.com/byusi/dlb)

## 贡献指南
欢迎通过以下方式参与贡献：
1. 提交 Issue 报告问题
2. Fork 仓库后发起 Pull Request
3. 完善多语言翻译文件
4. 编写测试用例

## 技术支持
如遇使用问题，请优先查阅：
```bash
dlb --help
```

或提交 Issue 至项目仓库，我们将尽快为您解答。