kuanyuchen/ffmpeg-youtube-live

Simple cross-platform FFMPEG streaming to YouTube

YouTube Live via FFmpeg

FFmpeg can easily be used to stream to YouTube Live for streaming broadcasts. These Python scripts compute the optimal parameters. Should work on any OS (Mac, Linux, Windows).

Linux:	requires X11, not Wayland (choose at login)
FFmpeg:	>= 3.0 required
Python:	>= 3.6 required

Contents

• YouTube Live via FFmpeg
  • Install
  • Usage
    • Webcam
    • Screen Share
    • Several video files
      • stream all .avi in ~/Videos
      • stream endlessly (repeating) all .avi in ~/Videos
    • Several audio files
    • Loop single video endlessly
    • Screen capture to disk
  • Notes
    • FFmpeg References
      • Windows

Install

From PyPi:

python -m pip install YouTubeLiveFFmpeg

Or for the latest copy from Github:

python -m pip install -e .

Usage

In all cases, you must first configure YouTube Live. Then your chosen input will stream live on YouTube Live.

In the non-file streaming scripts, you can specify your video/audio device if desired at the top of the script. You can find device names with commands like:

• Windows: ffmpeg -list_devices true -f dshow -i dummy
• Mac: ffmpeg -f avfoundation -list_devices true -i ""
• Linux: v4l2-ctl --list-devices

Webcam

Audio is included:

python Webcam2YouTubeLive.py

Screen Share

Audio is included:

python Screenshare2YouTubeLive.py

-fps	set frames/second
-res	set resolution XxY of your screen
-o	set origin (upper left)

Several video files

Glob list of video files to stream:

python FileGlob2YouTubeLive.py path pattern

-loop

optionally loop endlessly the globbed file list

stream all .avi in ~/Videos

python FileGlob2YouTubeLive.py ~/Videos "*.avi"

stream endlessly (repeating) all .avi in ~/Videos

python FileGlob2YouTubeLive.py ~/Videos "*.avi" -loop

Several audio files

Glob list of video files to stream. Note you must include a static image (could be your logo):

python FileGlob2YouTubeLive.py path pattern -i image

path path to where video files are pattern e.g. "*.avi" pattern matching video files -i filename of image to use as stream background

e.g. stream all .mp3 audio under ~/Library directory:

python FileGlob2YouTubeLive.py ~/Library "*.mp3" -i mylogo.jpg

Loop single video endlessly

FileLoop2YouTubeLive.py videofile

Screen capture to disk

This is NOT streaming, just saves to a file on your disk, perhaps for upload as a standard non-live YouTube video:

python ScreenCapture2disk.py myvid.avi

Notes

• FFmpeg Ubuntu PPA
• Reference webpage
• Test videos for looping/globbing

FFmpeg References

• streaming
• webcam

Windows

• DirectShow device selection
• DirectShow examples