/livestreamer

Command-line utility that extracts streams from various services and pipes them into a video player of choice.

Primary LanguagePythonBSD 2-Clause "Simplified" LicenseBSD-2-Clause

Livestreamer

https://badge.fury.io/py/livestreamer.png https://secure.travis-ci.org/chrippa/livestreamer.png https://pypip.in/d/livestreamer/badge.png docs/_static/flattr-badge.png

Livestreamer is CLI program that extracts streams from various services and pipes them into a video player of choice.

Features

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, e.g. Dailymotion, Livestream, Justin.tv, Twitch, UStream and YouTube Live.

Installing

The latest stable version is available to install using pip:

$ pip install livestreamer

or installing from a source directory:

$ python setup.py install

The Hitchhiker’s Guide to Python has guides helping you install Python + pip on the most common operating systems.

Updating

$ pip install --upgrade livestreamer

Usage

The default behaviour of Livestreamer is to transport a stream to your player software (default is VLC).

$ livestreamer twitch.tv/day9tv best
[cli][info] Found matching plugin twitch for URL twitch.tv/day9tv
[cli][info] Opening stream: source
[cli][info] Starting player: vlc

For more in-depth usage and install instructions see the full documentation available at http://livestreamer.tanuki.se/.

Related software

Feel free to add any Livestreamer related things to the wiki.

Contributing

If you wish to report a bug or contribute code, please take a look at CONTRIBUTING.rst first.