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