Skip to main content

Smart downloader for Reddit hosted videos

Project description


HitCount Build Status Python version Current Release

Smart downloader for Reddit hosted videos


  • Download local hosted videos with audio.
  • Requires only requests and FFmpeg.
  • Ability to decide quality.
  • Bypass bot detection.


redvid requires Python 3.

Use pip to install the package from PyPI:

pip install redvid

Or, install the latest version of the package from GitHub:

pip install git+


Using redvid to download a video:

> python --help

usage: [-h] -u URL [-p PATH] [-o] [-mxq] [-mnq] [-mxd MAXDURATION]
                  [-mxs MAXSIZE] [-am] [-px PROXIES]

Argument parser for redvid module

required arguments:
  -u URL, --url URL     Post URL for Reddit hosted video

optional arguments:
  -p PATH, --path PATH  Custom path for downloaded videos
  -o, --overwrite       Overwrite existing videos and ignore exception
  -mxq, --maxquality    Auto select maximum quality
  -mnq, --minquality    Auto select minimum quality
  -mxd MAXDURATION, --maxduration MAXDURATION
                        Ignore videos that exceed this duration (in seconds)
  -mxs MAXSIZE, --maxsize MAXSIZE
                        Ignore videos that exceed this size (in bytes)
  -am, --automax        Automatically download video with maximum size (Helps
                        for old reddit videos with unknown qualities)
  -px PROXIES, --proxies PROXIES
                        Download videos through proxies for blocked regions
  • via scripts:
from redvid import Downloader

reddit = Downloader(max_q=True)
reddit.url = ''


__import__('redvid').Downloader(url='', max_q=True).download()

Installing FFmpeg


(You may need to restart your pc after applying these steps)


sudo apt install ffmpeg

Mac OS:

  • install Homebrew:

    /usr/bin/ruby -e "$(curl -fsSL"

  • Then:

    $ brew install ffmpeg


Here are a few sample tests:



  • #20 Added a feature to create a folder in case it does not exist.


  • #18 Fixed bug when handling path that caused recursive directories.


  • #15 Fixed bug when fetching reddit videos with expiry date.


  • #11 redvid can now decide best quality according to given size.
  • Added support for old reddit videos.
  • Fixed bug where video qualities list can't be parsed.


  • #8 Added the ability to disable logging.
  • Maximum video size can be set.
  • #9 Maximum video duration can be set.


  • #7 Fixed a bug with quality fetching.


  • download() will return file path again.


  • #5 Can now download urls with fromat.
  • #4 PATH can be choosed instead of current dir.
  • #3 Max/Min quality can be automatically set to skip quality query.
  • Added ffmpeg encoding to videos with no sound to be uploadable on some platforms.
  • Adjusted printed text and progress bars.

Stargazers over time

Stargazers over time


Please contribute! If you want to fix a bug, suggest improvements, or add new features to the project, just open an issue or send me a pull request.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Built Distribution

redvid-1.2.0-py3-none-any.whl (12.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page