bdfr

Download videos/images from the specified links to URL or ID's of posts

$ bdfr download [path/to/output_directory] [[-l|--link]] [post_url]

$ bdfr download [path/to/output_directory] [[-u|--user]] [reddit_user] --submitted

$ bdfr archive [path/to/output_directory] [[-s|--subreddit]] '[Python, all, mindustry]' [[-L|--limit]] 10

$ bdfr download [path/to/output_directory] [[-s|--subreddit]] Python [[-S|--sort]] top [[-t|--time]] all [[-L|--limit]] 10

$ bdfr clone [path/to/output_directory] [[-s|--subreddit]] Python --skip mp4 --skip gif --make-hard-links

$ bdfr download [path/to/output_directory] [[-u|--user]] me --saved --authenticate --file-scheme '[ {POSTID}_{TITLE}_{UPVOTES} ]' --no-dupes --search-existing

bdfr [OPTIONS] SUBREDDIT|URL [SUBREDDIT|URL ...]

-h, --help
    Show help message and exit

--allow-insecure
    Allow insecure download sources (use at own risk)

--allow-unsafe
    Allow unsafe download sources (use at own risk)

-c COOKIES, --cookies COOKIES
    Netscape cookies file for authentication

--delay DELAY
    Seconds between requests (default: 1.0)

-D, --flatten
    Flatten output to single directory

-f FILTER, --filter FILTER
    Path to post/media filter file

--ignore-errors
    Continue despite download errors

-l LIMIT, --limit LIMIT
    Max posts to download per subreddit

--no-bar
    Disable progress bar

--no-duplicates
    Skip already downloaded files

-o OUTPUT, --output OUTPUT
    Output directory (default: ./output)

--parallel PARALLEL
    Parallel downloads (default: 5)

-p PASSWORD, --password PASSWORD
    Reddit account password

--site-config SITE_CONFIG
    Custom site configuration file

--subreddit-cache CACHE
    Subreddit cache file path

-t, --threads THREADS
    Number of fetch threads (default: 1)

-u USERNAME, --username USERNAME
    Reddit account username

--version
    Show version and exit

--write-info-json
    Save post info as JSON files

--write-subs
    Download embedded subtitles

bdfr (Batch Download From Reddit) is a powerful command-line utility for downloading images, videos, GIFs, albums, and other media from Reddit subreddits, user profiles, or specific posts. It fetches posts via Reddit's API, handles pagination automatically, and supports filtering by domain, file type, score, or custom rules. Media is organized into directories by subreddit, post ID, or flattened structure.

Key capabilities include parallel downloads for speed, duplicate skipping, progress bars, rate limiting to avoid bans, and resuming interrupted downloads. It extracts content from supported hosts like Imgur, Gfycat, and Reddit uploads. Authentication via username/password, cookies, or OAuth enables private subreddit access. Ideal for archiving content offline while respecting Reddit's terms.

Developed in Python, it's lightweight, extensible via filter/site config files, and actively maintained on GitHub.

Heavy usage may require Reddit OAuth app credentials to avoid rate limits or bans. Not all Reddit changes are instantly supported; check GitHub issues. Python 3.7+ required. Respect content creators' copyrights and Reddit ToS.

pip install bdfr
Or from source: pip install git+https://github.com/aliparlakci/bdfr.git

bdfr -o ~/Downloads -l 50 -t 4 datascience
Downloads top 50 posts from r/datascience with 4 threads.

Use -u USER -p PASS or --cookies file.txt for private subs. OAuth recommended for high volume.

Originated as reddit_video_downloader by bootlegret in 2017, forked and renamed bdfr by aliparlakci around 2020. Evolved from video-only to full media support, adding API integration, filters, and parallelism amid Reddit API changes.

gallery-dl(1), yt-dlp(1), curl(1)