Youtube Live Stream with Docker

With this dockerized app, you can use a webcam to stream live video to YouTube.

It was developer for Raspberry Pi, but of course it works with any type of HW as long as it supports Docker.

As I always forgot to turn on/turn off the stream, now it does it automatically based on the "present" devices on your network. This is achieved with a MAC whitelist. If a MAC address is in the list, that means if it's present at your network, the stream will shut down automatically. If it's not present then the stream goes live.

                +---------------------------+
                |                           +
                |                yes+---->stop
                |                ^        stream
                |                |
                v                +
start +-----> scan devices +---> is whitelisted MAC
                ^                present?
                |                +
                |                |
                |                v
                |                no+----->start
                |                         stream
                |                           +
                +---------------------------+

Setup

1. Install Docker 🐳
   • curl -sSL https://get.docker.com | sh
2. Install docker-compose
   • sudo pip install docker-compose OR sudo pip3 install docker-compose
3. Clone this repo
   • git clone https://github.com/gaborvecsei/YouTube-Live-Stream-Docker.git
   • go inside the folder cd Youtube-Live-Stream-Docker
4. Edit docker-compose.yml
   • Change YOUTUBE_LIVE_KEY to your personal youtube live stream key which you can find at https://www.youtube.com/live_dashboard
   • Under devices change the host mapping if necessary. (By default it uses the video0).
     • For example if you'd like to use video1 device than change it to: /dev/video1:/dev/video0
5. Whitelist device MAC addresses
   • Inside stream_app_image/code/start_app.py edit the variable: STOP_WHEN_PRESENT_MAC_DICT
   • This dict is responsible for keeping safe mac addresses, so when this device is present based on arp-scan or nmap we know, we can shut down the stream
6. YouTube Private Settings
   • Don't forget to set yout live stream to private at YouTube Live Dashboard

Start

• sudo docker-compose up -d

(For logs you can use sudo docker-compose logs or inside the code (both of the docker images) folders you can find the log files)

Stop

• sudo docker-compose down

TODO

• device scanning for automatic streamin
• logging to DB when was the stream live, which device, etc...
• easily switch to "basic mode". When there is no device scan, it streams when I start it.
• easily editable csv for whitelisting
• comments
• send message when stream started/stopped

About

Gábor Vecsei

• LinkedIn
• Twitter
• Github
• Personal Blog