redvid

Smart downloader for Reddit hosted videos

Features

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

Installation

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+https://github.com/elmoiv/redvid.git

Usage

Using redvid to download a video:

• via terminal (using credvid.py):

> python credvid.py --help

usage: credvid.py [-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 = 'https://v.redd.it/c8oic7ppc2751'
reddit.download()

or

__import__('redvid').Downloader(url='https://v.redd.it/c8oic7ppc2751', max_q=True).download()

Installing FFmpeg

Windows:

https://m.wikihow.com/Install-FFmpeg-on-Windows

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

Linux:

sudo apt install ffmpeg

Mac OS:

• install Homebrew:

  /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

• Then:

  $ brew install ffmpeg

Tests

Here are a few sample tests:

• Video only
• Video with audio
• [NEW] Get best quality according to given size (Automated)
• Choose PATH
• Auto-detect maximum quality
• Auto-detect minimum quality
• Skip file check and overwrite
• Silent download (No logging)
• Set maximum video size
  • Set maximum video size (different technique)
• Set maximum video duration
  • Set maximum video duration (different technique)

Changelog

v1.1.2:

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

v1.1.1:

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

v1.1.0:

• #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.

v1.0.9:

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

v1.0.8:

• #7 Fixed a bug with quality fetching.

v1.0.7:

• download() will return file path again.

v1.0.6:

• #5 Can now download urls with v.reddit.it 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

Contributing

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.