imvickykumar999/stream-downloader repository overview

⁠YouTube Stream Downloader & Broadcaster

A robust Flask web application that simplifies continuous broadcasting. It uses yt-dlp to download a source YouTube video in high quality and ffmpeg to continuously restream it to your chosen RTMP destination (on YouTube).

⁠🐳 Quick Start with Docker (Recommended)

The easiest way to run the application is by pulling the pre-built Docker image from Docker Hub. The image contains all the necessary dependencies, including the ffmpeg system binary.

⁠1. Pull the Image

docker pull imvickykumar999/stream-downloader

⁠2. Run the Container

docker run -p 5000:5000 -d imvickykumar999/stream-downloader

⁠(optional) to run same image on another port

docker run -d --name stream-downloader-1 -p 5001:5000 imvickykumar999/stream-downloader:latest

⁠3. Open the UI

Navigate to http://localhost:5000⁠ in your web browser.

(Username: admin, Password: password)

From the modern web interface, you'll be able to:

1. Input the Source YouTube ID you wish to broadcast.
2. Input your destination Stream Key.
3. Click Start Stream to initiate the background yt-dlp download and ffmpeg streaming cycle.

⁠🛠 Docker Helper Commands

Here are some useful commands to manage your running stream container. First, find your container ID or name by running:

docker ps

(You will need to replace <container_id> in the commands below with your actual container ID or name)

View Logs:

docker logs --tail 50 -f <container_id>

Stop Container:

docker stop <container_id>

Start Container (if stopped):

docker start <container_id>

Restart Container:

docker restart <container_id>

Remove Container:

docker rm -f <container_id>