fc9246478394c5a3cc67d2ca05eea5442792712b
[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 Author "Me"
167 Copyright "Super MegaCorp"
168 Title "Test stream from disk"
169 Comment "Test comment"
170
171 </Stream>
172
173 ##################################################################
174 # Another stream : Real with audio only at 32 kbits
175
176 <Stream test.ra>
177
178 Feed feed1.ffm
179 Format rm
180 AudioBitRate 32
181 NoVideo
182 NoAudio
183
184 </Stream>
185
186 ##################################################################
187 # Another stream : Real with audio and video at 64 kbits
188
189 #<Stream test.rm>
190
191 #Feed feed1.ffm
192 #Format rm
193
194 #AudioBitRate 32
195 #VideoBitRate 128
196 #VideoFrameRate 25
197 #VideoGopSize 25
198 #NoAudio
199
200 #</Stream>
201
202 <Stream test2.rm>
203
204 Feed feed1.ffm
205 Format rm
206
207 VideoBitRate 128
208 VideoFrameRate 15
209 VideoGopSize 25
210 VideoSize    320x240
211 AudioBitRate 64
212
213 </Stream>
214
215 ##################################################################
216 # Another stream : Multipart JPEG
217
218 #<Stream test.mjpg>
219 #
220 #Feed feed1.ffm
221 #Format mpjpeg
222 #
223 #VideoFrameRate 2
224 #VideoIntraOnly
225 #NoAudio
226 #
227 #</Stream>
228
229 ##################################################################
230 # Another stream : Multipart JPEG
231
232 #<Stream test.jpg>
233 #
234 #Feed feed1.ffm
235 #Format jpeg
236 #
237 ## the parameters are choose here to take the same output as the
238 ## Multipart JPEG one.
239 #VideoFrameRate 2 
240 #VideoIntraOnly
241 ##VideoSize 352x240
242 #NoAudio
243 #
244 #</Stream>
245
246 ##################################################################
247 # Another stream : Flash
248
249 #<Stream test.swf>
250
251 #Feed feed1.ffm
252 #Format swf
253 #
254 #VideoFrameRate 2
255 #VideoIntraOnly
256 #NoAudio
257 #
258 #</Stream>
259
260
261 ##################################################################
262 # Another stream : ASF compatible
263
264 <Stream test.asf>
265
266 Feed feed1.ffm
267 Format asf
268 #
269 VideoFrameRate 15
270 VideoSize 352x240
271 VideoBitRate 256
272 VideoGopSize 30
273 AudioBitRate 64
274 StartSendOnKey
275
276 </Stream>
277
278 <Stream testv.asf>
279
280 Feed feed1.ffm
281 Format asf
282 #
283 VideoFrameRate 15
284 VideoSize 352x240
285 VideoBitRate 256
286 VideoGopSize 30
287 NoAudio
288 StartSendOnKey
289
290 </Stream>
291
292 <Stream testv2.asf>
293
294 Feed feed1.ffm
295 Format asf
296 #
297 VideoFrameRate 15
298 VideoSize 352x240
299 VideoBitRate 128
300 VideoGopSize 30
301 NoAudio
302 StartSendOnKey
303
304 </Stream>
305
306 ##################################################################
307 # Special stream : server status
308
309 <Stream stat.html>
310
311 Format status
312
313 FaviconURL http://pond1.gladstonefamily.net:8080/favicon.ico
314
315 </Stream>
316
317
318 <Redirect index.html>
319 # maps index.html to the appropriate site
320 URL http://ffmpeg.sourceforge.net/
321 </Redirect>