Awesome Open Source
Awesome Open Source

Docker Pulls

Live Downloader

Monitor and download live streams from YouTube.

Features

System Requirements

Tested on macOS up to 11.2.3, should be working on Ubuntu and RHEL. Running live-dl inside a container is recommended.

Run live-dl Inside a Container with Docker

The simplest way to use live-dl is executing it inside a container. The following command will print the help message of live-dl:

docker run --rm -it sparanoid/live-dl:latest

Run live-dl in interactive mode:

docker run --rm -it \
  sparanoid/live-dl:latest \
  'UC1opHUrw8rvnsadT-iGp7Cg'

Run live-dl as a Docker daemon:

docker run --rm -itd \
  sparanoid/live-dl:latest \
  'UC1opHUrw8rvnsadT-iGp7Cg'

Run live-dl with host volume mounted:

# Mount host volume for download directory:
docker run --rm -itd \
  -v $(pwd)/downloads:/opt/live-dl/downloads \
  sparanoid/live-dl:latest \
  'UC1opHUrw8rvnsadT-iGp7Cg'

# Mount host volume for custom config.yml:
docker run --rm -itd \
  -v $(pwd)/config.yml:/opt/live-dl/config.yml \
  sparanoid/live-dl:latest \
  'UC1opHUrw8rvnsadT-iGp7Cg'

# Mount host volume for custom cookies.txt:
docker run --rm -itd \
  -v $(pwd)/youtube.com_cookies.txt:/opt/live-dl/cookies.txt \
  sparanoid/live-dl:latest \
  'UC1opHUrw8rvnsadT-iGp7Cg'

You can extract your current cookies simply via Get cookies.txt Google Chrome extension.

Run live-dl with Docker Compose

version: '3'

x-defaults: &defaults
  image: sparanoid/live-dl:latest
  restart: always
  volumes:
    - ./config.yml:/opt/live-dl/config.yml
    - ./youtube.com_cookies.txt:/opt/live-dl/cookies.txt
    - ./downloads:/opt/live-dl/downloads

services:
  minatoaqua:
    <<: *defaults
    command: https://www.youtube.com/channel/UC1opHUrw8rvnsadT-iGp7Cg --debug

  uruharushia:
    <<: *defaults
    command: https://www.youtube.com/channel/UCl_gCybOJRIgOXw6Qb4qJzQ --debug

Run live-dl Locally

Run ./live-dl without any parameter to print help message.

You can run this script in background with nohup:

# Start process
nohup bash live-dl https://www.youtube.com/channel/UC1opHUrw8rvnsadT-iGp7Cg &>/tmp/live-dl-minatoaqua.log &

# View processes
ps aux | grep live-dl
501 94552   964   0  9:38PM ttys009    0:00.06 bash live-dl https://www.youtube.com/channel/UC1opHUrw8rvnsadT-iGp7Cg
501 94765   964   0  9:39PM ttys009    0:00.00 grep live-dl

# Stop process
kill 94552

License

AGPL-3.0


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (54,453
shell (10,401
docker (2,919
bash (628
docker-compose (397
youtube (377
ffmpeg (320
live (101
mp4 (79
youtube-dl (79
livestream (52
aria2 (46
jq (23