Bulk Downloader for Reddit 使用教程

1. 项目介绍

Bulk Downloader for Reddit (BDFR) 是一个用于从 Reddit 下载和归档内容的工具。它可以帮助用户备份数据，或者用于研究数据的收集。BDFR 非常灵活，可以通过广泛的命令行接口在脚本中使用。

主要功能

• 下载内容：从 Reddit 下载图片、视频等内容。
• 归档数据：下载提交数据本身，包括提交详情、点赞数、文本、统计数据以及所有评论。
• 克隆模式：同时执行下载和归档功能，效率更高。

支持的来源

• 子版块 (Subreddit)
• 多子版块 (Multireddit)
• 用户列表
• 单个链接

2. 项目快速启动

安装

BDFR 需要 Python 3.9 或更高版本。请确保您的 Python 版本符合要求。

# 使用 pip 安装
python3 -m pip install bdfr --upgrade

# 或者使用 pipx 安装
python3 -m pipx install bdfr

更新

# 使用 pip 更新
python3 -m pip install bdfr --upgrade

# 使用 pipx 更新
pipx upgrade bdfr

检查版本

bdfr --version

安装 Shell 补全

bdfr completions

快速使用示例

# 下载指定子版块的内容
bdfr download /path/to/output --subreddit Python -L 10

# 归档指定用户的内容
bdfr archive /path/to/output --user reddituser --submitted -L 100

# 克隆模式
bdfr clone /path/to/output --subreddit 'Python, all, mindustry' -L 10

3. 应用案例和最佳实践

案例1：备份个人收藏

bdfr download /path/to/output --user me --saved --authenticate -L 25 --file-scheme '[POSTID]'

案例2：归档特定子版块

bdfr archive /path/to/output --subreddit all --format yaml -L 500 --folder-scheme ''

最佳实践

• 使用配置文件：通过 YAML 文件传递选项，简化命令行参数。
• 多实例运行：使用 --log 选项指定日志文件路径，以便在多实例运行时管理日志。
• 模块禁用：使用 --disable-module 禁用特定模块，以提高性能或避免特定问题。

4. 典型生态项目

1. Reddit Enhancement Suite (RES)

• 介绍：一个浏览器扩展，增强 Reddit 的用户体验。
• 链接：https://redditenhancementsuite.com/

2. Reddit Save Manager

• 介绍：一个工具，帮助用户管理和导出 Reddit 收藏的内容。
• 链接：https://github.com/shadow-of-colossus/reddit-save-manager

3. Reddit Archiver

• 介绍：一个简单的脚本，用于归档 Reddit 内容。
• 链接：https://github.com/voussoir/reddit

通过这些工具，您可以更全面地管理和归档 Reddit 内容，满足不同的需求。