* Updated so that some streams actually work!
[ffmpeg.git] / doc / ffserver.conf
1 # Port on which the server is listening. You must select a different
2 # port from your standard http web server if it is running on the same
3 # computer.
4
5 Port 8090
6
7 # Address on which the server is bound. Only useful if you have
8 # several network interfaces.
9
10 BindAddress 0.0.0.0
11
12 # Number of simultaneous requests that can be handled. Since FFServer
13 # is very fast, this limit is determined mainly by your Internet
14 # connection speed.
15
16 MaxClients 1000
17
18 # Access Log file (uses standard Apache log file format)
19 # '-' is the standard output
20
21 CustomLog -
22
23 ##################################################################
24 # Definition of the live feeds. Each live feed contains one video
25 # and/or audio sequence coming from an ffmpeg encoder or another
26 # ffserver. This sequence may be encoded simultaneously with several
27 # codecs at several resolutions.
28
29 <Feed feed1.ffm>
30
31 # You must use 'ffmpeg' to send a live feed to ffserver. In this
32 # example, you can type:
33
34 # ffmpeg http://localhost:8090/feed1.ffm
35
36 # ffserver can also do time shifting. It means that it can stream any
37 # previously recorded live stream. The request should contain:
38 # "http://xxxx?date=[YYYY-MM-DDT][[HH:]MM:]SS[.m...]".You must specify
39 # a path where the feed is stored on disk. You also specify the
40 # maximum size of the feed (100M bytes here). Default:
41 # File=/tmp/feed_name.ffm FileMaxSize=5M
42
43 File /tmp/feed1.ffm
44 FileMaxSize 50M
45
46 </Feed>
47
48 ##################################################################
49 # Now you can define each stream which will be generated from the
50 # original audio and video stream. Each format has a filename (here
51 # 'test128.mpg'). FFServer will send this stream when answering a
52 # request containing this filename.
53
54 <Stream test1.mpg>
55
56 # coming from live feed 'feed1'
57 Feed feed1.ffm
58
59 # Format of the stream : you can choose among:
60 # mpeg       : MPEG1 multiplexed video and audio
61 # mpegvideo  : only MPEG1 video
62 # mp2        : MPEG audio layer 2
63 # mp3        : MPEG audio layer 3 (currently sent as layer 2)
64 # rm         : Real Networks compatible stream. Multiplexed audio and video.
65 # ra         : Real Networks compatible stream. Audio only.
66 # mpjpeg     : Multipart JPEG (works with Netscape without any plugin)
67 # jpeg       : Generate a single JPEG image.
68 # asf        : ASF compatible stream (Windows Media Player format). Not finished yet.
69 # swf        : Macromedia flash(tm) compatible stream
70 # avi        : AVI format (open divx video, mpeg audio sound)
71 # master     : special ffmpeg stream used to duplicate a server
72
73 Format mpeg
74
75 # Bitrate for the audio stream. Codecs usually support only a few different bitrates. 
76
77 AudioBitRate 32
78
79 # Number of audio channels : 1 = mono, 2 = stereo
80
81 AudioChannels 1
82
83 # Sampling frequency for audio. When using low bitrates, you should
84 # lower this frequency to 22050 or 11025. The supported frequencies
85 # depend on the selected audio codec.
86
87 AudioSampleRate 44100
88
89 # Bitrate for the video stream.
90 VideoBitRate 64
91
92 # Number of frames per second
93 VideoFrameRate 3
94
95 # Size of the video frame : WxH (default: 160x128)
96 # W : width, H : height
97 # The following abbreviation are defined : sqcif, qcif, cif, 4cif
98 VideoSize    160x128
99
100 # transmit only intra frames (useful for low bitrates, but kills frame rate) 
101 #VideoIntraOnly
102
103 # If non intra only, an intra frame is transmitted every VideoGopSize
104 # frames Video synchronization can only begin at an I frames.
105 VideoGopSize 12
106
107 # Choose your codecs: 
108
109 #AudioCodec mp2
110 #VideoCodec mpeg1video
111
112 # Suppress audio
113 #NoAudio
114
115 # Suppress video
116 #NoVideo
117
118 </Stream>
119
120 # second mpeg stream with high frame rate
121
122 #<Stream test2.mpg>
123 #Feed feed1.ffm
124 #Format mpegvideo
125 #VideoBitRate 128
126 #VideoFrameRate 25
127 ###VideoSize    352x240
128 #VideoGopSize 25
129 #NoAudio
130 #</Stream>
131 #
132 ##################################################################
133 # A stream coming from a file : you only need to set the input
134 # filename and optionnally a new format. Supported conversions:
135 #    avi -> asf
136 #
137
138 # another file streaming
139 <Stream file.rm>
140
141 File "/usr/local/httpd/htdocs/tlive.rm"
142 NoAudio
143
144 </Stream>
145
146 <Stream file.asf>
147
148 File "/usr/local/httpd/htdocs/test.asf"
149 NoAudio
150
151 </Stream>
152
153 ##################################################################
154 # Another stream : Real with audio only at 32 kbits
155
156 <Stream test.ra>
157
158 Feed feed1.ffm
159 Format rm
160 AudioBitRate 32
161 NoVideo
162 NoAudio
163
164 </Stream>
165
166 ##################################################################
167 # Another stream : Real with audio and video at 64 kbits
168
169 #<Stream test.rm>
170
171 #Feed feed1.ffm
172 #Format rm
173
174 #AudioBitRate 32
175 #VideoBitRate 128
176 #VideoFrameRate 25
177 #VideoGopSize 25
178 #NoAudio
179
180 #</Stream>
181
182 <Stream test2.rm>
183
184 Feed feed1.ffm
185 Format rm
186
187 VideoBitRate 128
188 VideoFrameRate 15
189 VideoGopSize 25
190 VideoSize    320x240
191 AudioBitRate 64
192
193 </Stream>
194
195 ##################################################################
196 # Another stream : Multipart JPEG
197
198 #<Stream test.mjpg>
199 #
200 #Feed feed1.ffm
201 #Format mpjpeg
202 #
203 #VideoFrameRate 2
204 #VideoIntraOnly
205 #NoAudio
206 #
207 #</Stream>
208
209 ##################################################################
210 # Another stream : Multipart JPEG
211
212 #<Stream test.jpg>
213 #
214 #Feed feed1.ffm
215 #Format jpeg
216 #
217 ## the parameters are choose here to take the same output as the
218 ## Multipart JPEG one.
219 #VideoFrameRate 2 
220 #VideoIntraOnly
221 ##VideoSize 352x240
222 #NoAudio
223 #
224 #</Stream>
225
226 ##################################################################
227 # Another stream : Flash
228
229 #<Stream test.swf>
230
231 #Feed feed1.ffm
232 #Format swf
233 #
234 #VideoFrameRate 2
235 #VideoIntraOnly
236 #NoAudio
237 #
238 #</Stream>
239
240
241 ##################################################################
242 # Another stream : ASF compatible
243
244 <Stream test.asf>
245
246 Feed feed1.ffm
247 Format asf
248 #
249 VideoFrameRate 15
250 VideoSize 352x240
251 VideoBitRate 128
252 VideoGopSize 30
253 AudioBitRate 64
254
255 </Stream>
256
257 ##################################################################
258 # Special stream : server status
259
260 <Stream stat.html>
261
262 Format status
263
264 </Stream>