Added Launch, FaviconURL and Redirect examples
[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 # This the maximum amount of kbit/sec that you are prepared to
19 # consume when streaming to clients
20
21 MaxBandwidth 1000
22
23 # Access Log file (uses standard Apache log file format)
24 # '-' is the standard output
25
26 CustomLog -
27
28 ##################################################################
29 # Definition of the live feeds. Each live feed contains one video
30 # and/or audio sequence coming from an ffmpeg encoder or another
31 # ffserver. This sequence may be encoded simultaneously with several
32 # codecs at several resolutions.
33
34 <Feed feed1.ffm>
35
36 # You must use 'ffmpeg' to send a live feed to ffserver. In this
37 # example, you can type:
38
39 # ffmpeg http://localhost:8090/feed1.ffm
40
41 # ffserver can also do time shifting. It means that it can stream any
42 # previously recorded live stream. The request should contain:
43 # "http://xxxx?date=[YYYY-MM-DDT][[HH:]MM:]SS[.m...]".You must specify
44 # a path where the feed is stored on disk. You also specify the
45 # maximum size of the feed (100M bytes here). Default:
46 # File=/tmp/feed_name.ffm FileMaxSize=5M
47
48 File /tmp/feed1.ffm
49 FileMaxSize 200K
50
51 # Specify launch in order to start ffmpeg automatically
52 # Launch
53
54 </Feed>
55
56 ##################################################################
57 # Now you can define each stream which will be generated from the
58 # original audio and video stream. Each format has a filename (here
59 # 'test128.mpg'). FFServer will send this stream when answering a
60 # request containing this filename.
61
62 <Stream test1.mpg>
63
64 # coming from live feed 'feed1'
65 Feed feed1.ffm
66
67 # Format of the stream : you can choose among:
68 # mpeg       : MPEG1 multiplexed video and audio
69 # mpegvideo  : only MPEG1 video
70 # mp2        : MPEG audio layer 2
71 # mp3        : MPEG audio layer 3 (currently sent as layer 2)
72 # rm         : Real Networks compatible stream. Multiplexed audio and video.
73 # ra         : Real Networks compatible stream. Audio only.
74 # mpjpeg     : Multipart JPEG (works with Netscape without any plugin)
75 # jpeg       : Generate a single JPEG image.
76 # asf        : ASF compatible stream (Windows Media Player format). Not finished yet.
77 # swf        : Macromedia flash(tm) compatible stream
78 # avi        : AVI format (open divx video, mpeg audio sound)
79 # master     : special ffmpeg stream used to duplicate a server
80
81 Format mpeg
82
83 # Bitrate for the audio stream. Codecs usually support only a few different bitrates. 
84
85 AudioBitRate 32
86
87 # Number of audio channels : 1 = mono, 2 = stereo
88
89 AudioChannels 1
90
91 # Sampling frequency for audio. When using low bitrates, you should
92 # lower this frequency to 22050 or 11025. The supported frequencies
93 # depend on the selected audio codec.
94
95 AudioSampleRate 44100
96
97 # Bitrate for the video stream.
98 VideoBitRate 64
99
100 # Number of frames per second
101 VideoFrameRate 3
102
103 # Size of the video frame : WxH (default: 160x128)
104 # W : width, H : height
105 # The following abbreviation are defined : sqcif, qcif, cif, 4cif
106 VideoSize    160x128
107
108 # transmit only intra frames (useful for low bitrates, but kills frame rate) 
109 #VideoIntraOnly
110
111 # If non intra only, an intra frame is transmitted every VideoGopSize
112 # frames Video synchronization can only begin at an I frames.
113 VideoGopSize 12
114
115 # Choose your codecs: 
116
117 #AudioCodec mp2
118 #VideoCodec mpeg1video
119
120 # Suppress audio
121 #NoAudio
122
123 # Suppress video
124 #NoVideo
125
126 #VideoQMin 3
127 #VideoQMax 31
128
129 # Set this to the number of seconds backwards in time to start. Note that
130 # most players will buffer 5-10 seconds of video, and also you need to allow
131 # for a key frame to appear in the data stream.
132 #PreRoll 15
133
134 </Stream>
135
136 # second mpeg stream with high frame rate
137
138 #<Stream test2.mpg>
139 #Feed feed1.ffm
140 #Format mpegvideo
141 #VideoBitRate 128
142 #VideoFrameRate 25
143 ###VideoSize    352x240
144 #VideoGopSize 25
145 #NoAudio
146 #</Stream>
147 #
148 ##################################################################
149 # A stream coming from a file : you only need to set the input
150 # filename and optionnally a new format. Supported conversions:
151 #    avi -> asf
152 #
153
154 # another file streaming
155 <Stream file.rm>
156
157 File "/usr/local/httpd/htdocs/tlive.rm"
158 NoAudio
159
160 </Stream>
161
162 <Stream file.asf>
163
164 File "/usr/local/httpd/htdocs/test.asf"
165 NoAudio
166
167 </Stream>
168
169 ##################################################################
170 # Another stream : Real with audio only at 32 kbits
171
172 <Stream test.ra>
173
174 Feed feed1.ffm
175 Format rm
176 AudioBitRate 32
177 NoVideo
178 NoAudio
179
180 </Stream>
181
182 ##################################################################
183 # Another stream : Real with audio and video at 64 kbits
184
185 #<Stream test.rm>
186
187 #Feed feed1.ffm
188 #Format rm
189
190 #AudioBitRate 32
191 #VideoBitRate 128
192 #VideoFrameRate 25
193 #VideoGopSize 25
194 #NoAudio
195
196 #</Stream>
197
198 <Stream test2.rm>
199
200 Feed feed1.ffm
201 Format rm
202
203 VideoBitRate 128
204 VideoFrameRate 15
205 VideoGopSize 25
206 VideoSize    320x240
207 AudioBitRate 64
208
209 </Stream>
210
211 ##################################################################
212 # Another stream : Multipart JPEG
213
214 #<Stream test.mjpg>
215 #
216 #Feed feed1.ffm
217 #Format mpjpeg
218 #
219 #VideoFrameRate 2
220 #VideoIntraOnly
221 #NoAudio
222 #
223 #</Stream>
224
225 ##################################################################
226 # Another stream : Multipart JPEG
227
228 #<Stream test.jpg>
229 #
230 #Feed feed1.ffm
231 #Format jpeg
232 #
233 ## the parameters are choose here to take the same output as the
234 ## Multipart JPEG one.
235 #VideoFrameRate 2 
236 #VideoIntraOnly
237 ##VideoSize 352x240
238 #NoAudio
239 #
240 #</Stream>
241
242 ##################################################################
243 # Another stream : Flash
244
245 #<Stream test.swf>
246
247 #Feed feed1.ffm
248 #Format swf
249 #
250 #VideoFrameRate 2
251 #VideoIntraOnly
252 #NoAudio
253 #
254 #</Stream>
255
256
257 ##################################################################
258 # Another stream : ASF compatible
259
260 <Stream test.asf>
261
262 Feed feed1.ffm
263 Format asf
264 #
265 VideoFrameRate 15
266 VideoSize 352x240
267 VideoBitRate 256
268 VideoGopSize 30
269 AudioBitRate 64
270 StartSendOnKey
271
272 </Stream>
273
274 <Stream testv.asf>
275
276 Feed feed1.ffm
277 Format asf
278 #
279 VideoFrameRate 15
280 VideoSize 352x240
281 VideoBitRate 256
282 VideoGopSize 30
283 NoAudio
284 StartSendOnKey
285
286 </Stream>
287
288 <Stream testv2.asf>
289
290 Feed feed1.ffm
291 Format asf
292 #
293 VideoFrameRate 15
294 VideoSize 352x240
295 VideoBitRate 128
296 VideoGopSize 30
297 NoAudio
298 StartSendOnKey
299
300 </Stream>
301
302 ##################################################################
303 # Special stream : server status
304
305 <Stream stat.html>
306
307 Format status
308
309 FaviconURL http://pond1.gladstonefamily.net:8080/favicon.ico
310
311 </Stream>
312
313
314 <Redirect index.html>
315 # maps index.html to the appropriate site
316 URL http://ffmpeg.sourceforge.net/
317 </Redirect>