aboutsummaryrefslogtreecommitdiffhomepage
path: root/README.md
diff options
context:
space:
mode:
authorGravatar Christopher Rosell <chrippa@tanuki.se>2012-01-19 23:29:28 +0100
committerGravatar Christopher Rosell <chrippa@tanuki.se>2012-01-19 23:29:28 +0100
commit32cdb8581071f3abc54c72db5801ea19eaeb8498 (patch)
treebc68308a0cca9b79d7b6a78c8ea1f573d4ef1b98 /README.md
parent84971ae1501c316f4a5d1b0cb6f4492e3ef44ed7 (diff)
Use a markdown README instead.
Diffstat (limited to 'README.md')
-rw-r--r--README.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7a282eb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,49 @@
+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).
+