Redvid
Smart Downloader for Reddit Hosted Videos
Now available for Android*
## 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:
```bash
pip install redvid
```
Or, install the latest version of the package from GitHub:
```bash
pip install git+https://github.com/elmoiv/redvid.git
```
## Usage
Using *redvid* to download a video:
- via terminal (
See console commands):
```console
> redvid -u "https://v.redd.it/c8oic7ppc2751" -mxq
```
- via scripts:
```python
from redvid import Downloader
reddit = Downloader(max_q=True)
reddit.url = 'https://v.redd.it/c8oic7ppc2751'
reddit.download()
```
*or*
```python
__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](https://brew.sh/):
`/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](https://github.com/elmoiv/redvid/tree/master/tests/test1.py)
* [Video with audio](https://github.com/elmoiv/redvid/tree/master/tests/test2.py)
* [Get best quality according to given size (Automated)](https://github.com/elmoiv/redvid/tree/master/tests/test12.py)
* [Choose PATH](https://github.com/elmoiv/redvid/tree/master/tests/test3.py)
* [Auto-detect maximum quality](https://github.com/elmoiv/redvid/tree/master/tests/test4.py)
* [Auto-detect minimum quality](https://github.com/elmoiv/redvid/tree/master/tests/test5.py)
* [Skip file check and overwrite](https://github.com/elmoiv/redvid/tree/master/tests/test6.py)
* [Silent download (No logging)](https://github.com/elmoiv/redvid/tree/master/tests/test7.py)
* [Set maximum video size](https://github.com/elmoiv/redvid/tree/master/tests/test8.py)
* [Set maximum video size (different technique)](https://github.com/elmoiv/redvid/tree/master/tests/test9.py)
* [Set maximum video duration](https://github.com/elmoiv/redvid/tree/master/tests/test10.py)
* [Set maximum video duration (different technique)](https://github.com/elmoiv/redvid/tree/master/tests/test11.py)
* [Custom Filename](tests/test13.py)
## Console Commands
```console
> redvid --help
usage: redvid [-h] [-u URL] [-p PATH] [-o] [-mxq] [-mnq] [-mxd MAXDURATION]
[-mxs MAXSIZE] [-am] [-ad] [-px PROXIES] [-v] [-c]
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
-fn FILENAME, --filename FILENAME
Set custom filename for downloaded video
-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)
-ad, --autodir Automatically create path if correctly typed and does
not exist
-px PROXIES, --proxies PROXIES
Download videos through proxies for blocked regions
-v, --version Show redvid version
-nc, --noclean Don't clean temp folder after download is done
```
## Stargazers over time
[](https://starchart.cc/elmoiv/redvid)
## Contributing
Please contribute! If you want to fix a bug, suggest improvements, or add new features to the project, just [open an issue](https://github.com/elmoiv/redvid/issues) or send me a pull request.
**Android version of Redvid is not open-source.*