bdfr

Download posts from a subreddit

$ bdfr download [./output] --subreddit [Python] -L [10]

$ bdfr download [./output] --user [username] --submitted -L [100]

$ bdfr download [./output] --user me --saved --authenticate -L [25]

$ bdfr archive [./output] --user [username] --submitted --all-comments

$ bdfr clone [./output] --subreddit [Python] -L [10]

$ bdfr download [./output] --subreddit "[Python, programming, linux]" -L [10]

$ bdfr download [./output] --subreddit [Python] --search "[machine learning]" -L [20]

bdfr mode outputpath [options_]

bdfr (Bulk Downloader for Reddit) is a tool to download submissions, media, and data from Reddit. It can archive posts for research, backup saved content, or download media from subreddits.
The tool has three modes: download (downloads linked media like images and videos), archive (saves submission metadata, text, and comments in JSON/YAML/XML), and clone (performs both operations efficiently).

--subreddit name

Target subreddit(s), comma-separated for multiple

Target Reddit username; use "me" for authenticated user

Maximum number of submissions to process

Download user's submitted posts

Download user's saved posts (requires --authenticate)

Download user's upvoted posts (requires --authenticate)

Use OAuth2 authentication for private content

Search query to filter submissions

Sort order: hot, top, new, controversial, rising, relevance

Time filter: all, hour, day, week, month, year

Archive all comments on submissions

Custom filename format (e.g., '{POSTID}')

Increase output verbosity

~/.config/bdfr/default_config.cfg

Main configuration file with client ID, secret, and default options.

download

Download media linked in Reddit submissions

Archive submission data, metadata, and comments

Perform both download and archive operations

Requires Python 3.9 or above. Authentication is required for accessing saved posts, upvoted posts, and private multireddits. Reddit API rate limits apply. Some media hosts may block automated downloads.

BDFR was created as a modernized fork of earlier Reddit downloading tools, developed by Serene-Arc starting around 2020. It replaced the original Bulk Downloader for Reddit with improved architecture and maintained compatibility with Reddit's evolving API.

gallery-dl(1), youtube-dl(1), wget(1)