fetcher: use task loop for regular fetches
[hls-player:hls-player.git] / README
1 http live streaming player
2 ==========================
3
4 A simple HTTP Live Streaming player written in Python, using GStreamer.
5
6 Installation:
7
8     sudo python setup.py install
9
10 Play the sample clip from Apple:
11
12     hls-player http://devimages.apple.com/iphone/samples/bipbop/bipbopall.m3u8
13
14 or RTVE:
15
16     hls-player http://iphonelive.rtve.es/stream1.m3u8 -r http://m.rtve.es/live/
17
18 And that is the command line help:
19
20
21     Usage: hls-player [options] url...
22     
23     Options:
24       --version             show program's version number and exit
25       -h, --help            show this help message and exit
26       -v, --verbose         print some debugging (default: False)
27       -b BITRATE, --bitrate=BITRATE
28                             desired bitrate (default: 200000)
29       -k KEEP, --keep=KEEP  number of segments ot keep (default: 3, -1: unlimited)
30       -r URL, --referer=URL
31                             Sends the "Referer Page" information with URL
32       -D, --no-display      display no video (default: False)
33       -s, --save            save instead of watch (saves to /tmp/hls-player.ts)
34       -p PATH, --path=PATH  download files to PATH
35       -n N, --number=N      number of player to start (default: 1)
36
37
38 Read the IETF specification:
39     http://tools.ietf.org/html/draft-pantos-http-live-streaming-02