Files
vidgrab/README.md

37 lines
1.7 KiB
Markdown

[![Docker Stars Shield](https://img.shields.io/docker/stars/tedkulp/vidgrab.svg?style=flat-square)](https://hub.docker.com/r/tedkulp/vidgrab/)
[![Docker Pulls Shield](https://img.shields.io/docker/pulls/tedkulp/vidgrab.svg?style=flat-square)](https://hub.docker.com/r/tedkulp/vidgrab/)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://raw.githubusercontent.com/tedkulp/vidgrab/master/LICENSE)
# Vidgrab
Simple web interface to download videos with [youtube-dl](https://github.com/ytdl-org/youtube-dl) and store them on your server. Written in Typescript using [nest.js](https://nestjs.com).
![screenshot](img/screenshot.png)
## Setup
Vidgrab was written assuming that Docker would be used to deploy it. It requires redis for it's queuing functionality.
### Docker CLI
```shell
docker run -d --name vidgrab -E FILE_DIR=/vidgrab -v /vidgrab:/vidgrab -p 4200:4200 tedkulp/vidgrab
```
### Docker Compose
There is an example docker-compose.yml file [included](https://raw.githubusercontent.com/tedkulp/vidgrab/master/docker-compose.yml) in the repo. Use that directly to get a site running on port 3000 or modify to taste.
### Environment Variables
| Name | Default Value | Description |
| ---------- | --------------------- | -------------------------------------- |
| REDIS_HOST | localhost | Hostname of the redis server |
| REDIS_PORT | 6379 | Port to connect to for redis server |
| FILE_DIR | /tmp | Directory to store downloads |
| SITE_URL | http://localhost:4200 | URL to the site. Used for bookmarklet. |
## License
This software is available under the [MIT License](https://opensource.org/licenses/MIT).