Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 74 lines (47 sloc) 1.443 kb

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
  • YouTube

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"]
fd = stream.open()

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

    # do something with data

fd.close()
Something went wrong with that request. Please try again.