summaryrefslogtreecommitdiff
path: root/README
blob: fbec82fb7eb013f3da7b375e10c6df33ad8428e4 (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
104
105
106
107
108
109
110
111
112
 ________________________________________________________
|                                                        |
|                     [ 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 ( All video files & mp3/aac/Wav files )

 
 Webapp:
 -------

 Add iStreamdev to your iPhone home menu. This makes it looking likes an appstore app without Safari interface.

 Usage:
 ------

 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.
 This is the same for recorinds and videos files.
 To Stop the stream server, hit Stop stream button.

 Video thumbnails:
 iStreamdev takes videoname.tbn , poster.jpg or folder.jpg file ( from xbmc export library ) as thumbnail source, or grab a pi cture in the video stream if there's not.

 Channel logos: 
 Put your 80x80 png logos in logos/ folder. They needs to have the same name/caps as your channels.conf If a channel have a / character in the name, replace it by _ ( cf RTL/TELEVISION > RTL_TELEVISION.png ) 
 
 Music:
 iStreamdev generate a playlist from the requested file to the last file of the folder. Then you can goes Next easily. To play an album, just launch the first track.

 
 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 in ram with /dev/shm:

 mkdir /dev/shm/ram
 ln -s /dev/shm/ram ram
 
 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