c1d6d4f Sep 5, 2014
68 lines (51 sloc) 1.99 KB


Livestreamer is a :ref:`command-line utility <cli>` that pipes video streams from various services into a video player, such as VLC. The main purpose of Livestreamer is to allow the user to avoid buggy and CPU heavy flash plugins but still be able to enjoy various streamed content. There is also an :ref:`API <api_guide>` available for developers who want access to the video stream data.


Livestreamer is built upon a plugin system which allows support for new services to be easily added. Currently most of the big streaming services are supported, such as:

... and many more. A full list of plugins currently included can be found on the :ref:`plugin_matrix` page.


The default behaviour of Livestreamer is to playback a stream in the default player (VLC).

# pip install livestreamer
$ livestreamer best
[cli][info] Found matching plugin twitch for URL
[cli][info] Opening stream: source (hls)
[cli][info] Starting player: vlc

For more in-depth usage and install instructions see the User guide.

User guide

Livestreamer is made up of two parts, a :ref:`cli` and a library :ref:`API <api>`. See their respective sections for more information on how to use them.