Livestreamer

CLI program that helps launch various streaming services in a real player instead of flash.

Installing

$ sudo python setup.py install

Livestreamer is compatible with Python version >= 2.6 and 3.0.

Using

$ livestreamer --help

Example usage

Find out what stream qualities are available

$ livestreamer http://www.twitch.tv/ignproleague
Found streams: 240p, 360p, 480p, 720p, iphonehigh, iphonelow, live

Now play one of them

$ livestreamer http://www.twitch.tv/ignproleague 720p

Stream now playbacks in default player (VLC).

Saving arguments AKA config file

Livestreamer can read arguments from the file ~/.livestreamerrc. A example file:

player=mplayer
jtv-cookie=_jtv3_session_id=arandomhash

Notes

Currently supported sites are:

• Justin.tv/Twitch.tv
• Own3D.tv
• UStream

Justin.tv plugin requires rtmpdump with jtv token support (recent git).

Using livestreamer as a library

Livestreamer is also a library. Short example:

import livestreamer

url = "http://twitch.tv/day9tv"
channel = livestreamer.resolve_url(url)
streams = channel.get_streams()

stream = streams["720p"]
stream.open()

while True:
    data = stream.read(1024)
    if len(data) == 0:
        break

    # do something with data

stream.close()