https://github.com/kenjyco/yt-helper
Light wrapper to youtube-dl with a simplified CLI for downloading media
https://github.com/kenjyco/yt-helper
audio cli download ffmpeg kenjyco python rtmpdump sox video
Last synced: 5 months ago
JSON representation
Light wrapper to youtube-dl with a simplified CLI for downloading media
- Host: GitHub
- URL: https://github.com/kenjyco/yt-helper
- Owner: kenjyco
- License: other
- Created: 2017-02-24T01:11:46.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-11-30T17:03:23.000Z (over 1 year ago)
- Last Synced: 2025-11-29T05:32:00.872Z (7 months ago)
- Topics: audio, cli, download, ffmpeg, kenjyco, python, rtmpdump, sox, video
- Language: Python
- Homepage:
- Size: 49.8 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
## Install
Install system av tools
```
% sudo apt-get install -y ffmpeg sox rtmpdump
or
% brew install ffmpeg sox rtmpdump
```
Install with `pip`
```
% pip3 install yt-helper
```
## Usage
The `yt-download` script is provided
```
% venv/bin/yt-download --help
Usage: yt-download [OPTIONS] [ARGS]...
Wrapper to 'av_from_url'
- args: urls or filenames containing urls
Options:
-o, --template TEXT string representing generated filenames
-h, --max-height INTEGER maximum height of video (i.e. 1080, 720, 480,
240.. default 720)
-p, --playlist Allow downloading entire playlist
-t, --thumbnail Download thumbnail image of video
-d, --description Download description of video to a file
-s, --subtitles Embed subtitles in the downloaded video
-a, --audio-only Don't keep the video file if one was downloaded
-m, --mp3 Convert downloaded audio to MP3 file
-v, --verbose Show extra debugging output
--help Show this message and exit.
```
## Optional Installs
### Collections/models (QUERIES, URLS, FILES, COMMENTS)
In order to make use of the `QUERIES`, `URLS`, `FILES`, and `COMMENTS`
collections, you must also install the `redis-helper` package and have a Redis
server running.
If the collections/models are available, some functions will save relevant info
to them.
> See: https://github.com/kenjyco/redis-helper#intro
If you don't have [docker](https://docs.docker.com/get-docker) installed,
install Redis and start server
```
% sudo apt-get install -y redis-server
or
% brew install redis
% brew services start redis
```
Install with `pip`
```
% pip3 install redis-helper
```