summaryrefslogtreecommitdiff
path: root/README
blob: 33abebd09b669f07307b51b5177685a7bfbe5308 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
 ________________________________________________________
|                                                        |
|                     [ iStreamdev ]                     |
|________________________________________________________|

 Written by:                  
 Alib <aliboba@free.fr>
 
 Contributors		      
 The Troll

 Project's homepage:          
 http://projects.vdr-developer.org/projects/show/istreamdev
 

 Latest version available at: 
 http://projects.vdr-developer.org/projects/list_files/istreamdev

 git repository:
 git://projects.vdr-developer.org/istreamdev.git

 See the file COPYING for license information.

 About:
 -----
 
 iStreamdev lets you stream TV channels & recordings from VDR 
 and your Media files to your unjailbroken iPhone Quicktime player.

 Your iPhone needs to have at least firmware 3.0 to support
 HTTP Live Streaming protocol.
			 
 It gets vdr-streamdev plugins TS feeds, and recodes it   
 to TS mux with h264 level 3.0 video and mp3 audio using 
 ffmpeg. Segmenter receives output from pipe, cuts it in 
 10 seconds video file and updates the m3u8 playlist in
 live.
							 
							 
 Features:
 ---------

 - 100% webapp compatible user interface using iWebkit framework ( http://iwebkit.net )
 - Channel selection throught categories
 - Channels listed with logo and current epg.
 - Streaming format selection: Edge, 3g, Wifi
 - Recording streaming
 - Media streaming ( only videos for now ) 
 
 Webapp:
 -------

 Add iStreamdev to your iPhone home menu to launch it in 
 fullscreen mode as a normal app.

 Usage:
 ------

 Really simple. Select a channels category, then a channel. 
 Select your stream mode: Edge , 3g or Wifi. The Play icon
 will appear automatically after few seconds when the feed is
 ready.
 To Stop the stream server, hit Stop stream button.
 If a stream encoding is already running, to prevent multiple 
 users asking for different channels, it will automaticaly 
 redirect any access to iStreamdev on the current streaming 
 channel page.

 
 What you need:
 --------------

 - an http server with PHP5 enabled like apache or lighthttpd
 - having "at" package.
 - www-data user should allowed to use "at". 
   Check on your /etc/at/deny if www-data is there, and remove it if so.
 - PHP is allowed to use exec() function.
 - ffmpeg compiled with x264 support
 - segmenter: modified version now included in istreamdev path (http://www.ioncannon.net/programming/452/iphone-http-streaming-with-ffmpeg-and-an-open-source-segmenter/)

 Install iStreamdev:
 -------------------

 Copy the file in your webfolder. /istreamdev for example.
 Copy config_default.php to config.php and edit it. 
 $httpath  is your istreamdev http path NOT the full url 
 ( '/istreamdev/' NOT 'http://yourdomain/istreamdev' )

 the ram folder should be writable. If you want to prevent hard disk 
 usage, you can mount it as ram disk.
 
 Check everything is ok with ffmpeg by launching the above 
 command logued as your http server user ( www-data ) :

 ./istream.sh http://localhost:3000/TS/1 512k 64k 1 480x320 ./ 3 /usr/bin/ffmpeg /usr/bin/segmenter


 You should see ffmpeg access streamdev http://localhost:3000/TS/1 and 
 encode the stream.
 
 Now everything is ok you can login from your iphone: http://yourip/istreamdev