Revision 7be88db2

View differences:

README
6 6
Building
7 7
--------
8 8

  
9
Run "make". A new folder will be created with the name PeerStreamer-<version>.
10
You will find all the executables in this folder. PeerStreamer-<version>.tgz is
11
also created to ease distribution.
9
Run "make". A new folder will be created with the name
10
PeerStreamer-<version>. You will find all the executables in this
11
folder. PeerStreamer-<version>.tgz  and
12
PeerStreamer-<version>.tgz-stripped.tgz is also created to ease
13
distribution of binaries.
12 14

  
13 15
See the built-in help ("./streamer -h") for usage examples and options.
14 16

  
......
21 23
If the stream is a video file, run is as e.g.
22 24
./source.sh -f video.avi
23 25

  
24
If the stream "live", coming from a device with its own timing,
25
run it with the "-l" parameter as e.g.
26
If the stream is "live", coming from a device with its own timing, run
27
it with the "-l" parameter as e.g.
26 28
./source.sh -l -f /dev/dvb/adapter0/dvr0
27 29

  
28 30
For more options, see the help
29 31
./source.sh -h
30 32

  
31
Create a channels.conf file, distribute it to the users, and enjoy.
33
Create a channels.conf file, distribute it to the users, and enjoy. As
34
an alternative, you can also send the channels.conf to peerstreamer.org
35
for inclusion in the channel list.
32 36

  
33 37
Running a peer
34 38
--------------
35 39

  
36
The only thing you need is the channel descriptor. Currently, the only way to
37
provide this is to get the channels.conf file beonging to this channel.
40
Start the player with
38 41

  
39
Running the player
40
./chunker_player -q 50 -c <channelname> -p 8888
42
./player.sh
43

  
44
You can also use your custom channels.conf. In this case, copy the
45
channels.conf in this folder, and run the player as follows:
46

  
47
./chunker_player
41 48

  
42 49

  
43 50
Detailed instructions
44 51
=====================
45 52

  
46
PeerStreamer can be compiled in several ways, e.g. in a simple configuration that creates
47
only one binary. It can also be compiled in more complex versions that include a streamer
48
linked with a number of external libraries, as well as a custom made player application.
53
PeerStreamer can be compiled in several ways, e.g. in a simple
54
configuration that creates only one binary. It can also be compiled in
55
more complex versions that include a streamer linked with a number of
56
external libraries, as well as a custom made player application.
49 57

  
50
Below we provide instructions for teo versions, the simplest case and the most complex one.
51
The first one is useful for developers to understand the system. The second one is more
52
useful as an end-user version.
58
Below we provide instructions for two versions, the simplest case and
59
the most complex one. The first one is useful for developers to
60
understand the system. The second one is more useful as an end-user
61
version.
53 62

  
54 63

  
55 64
Building and running the simple version (GRAPES I/O)
......
58 67
Compilation
59 68
- - - - - -
60 69
Create executables by running:
61
make
70
make simple
62 71

  
63 72
Running the source
64 73
- - - - - - - - -
......
75 84
----------------------------------------------------------
76 85

  
77 86
The complex version contains a separate chunker and player application.
87
It also integrates with a number of external libraries, providing
88
additional functionalities and performance.
78 89

  
79 90
Compilation
80 91
- - - - - -
81 92
Create executables by running:
82
make pack
93
make
83 94

  
84 95
Running the source
85 96
- - - - - - - - -
97
The easiest way to start a source is to use the provided wrapper script:
98
source.sh. See the Quick Start instructions for examples.
99

  
100
If more control is needed, follow this procedure:
101

  
86 102
1, Start the source peer in one shell:
87 103
Streamers/streamer-ml-monl-chunkstream-static -f tcp://127.0.0.1:7777 -m 3
88 104

  
89 105
2, In another shell, go to the Chunker's folder
90 106
cd ChunkerPlayer/chunker_streamer
91 107

  
92
3, Verify that the streamer is set up correctly:
93
chunker.conf should contain:
94
outsideWorldUrl = "tcp://127.0.0.1:7777"
95

  
96 108
3, Start the chunker (after the source peer has been started!):
97 109
./chunker_streamer -i ~/video/big_bunny_orig/big_buck_bunny_480p_stereo.avi -a 128000 -v 500000
98 110
or
......
100 112

  
101 113
Running a peer
102 114
- - - - - - -
115
The only think a peers needs to run is a channel list. This can either
116
come from peerstreamer.org, or you can create and use your own.
117

  
118
In the first case, just start the included wrapper script:
119
./player.sh
120
This will download the most recent channel list and start playing.
121

  
122
You can also create your own channel list (see the provided example
123
channels.conf), and distribute it with the player. In this case, start
124
the player with the following command:
125
./chunker_player

Also available in: Unified diff