mention the two asf formats
[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 Port 8090
5
6 # Address on which the server is bound. Only useful if you have
7 # several network interfaces.
8 BindAddress 0.0.0.0
9
10 # Number of simultaneous requests that can be handled. Since FFServer
11 # is very fast, it is more likely that you will want to leave this high
12 # and use MaxBandwidth, below.
13 MaxClients 1000
14
15 # This the maximum amount of kbit/sec that you are prepared to
16 # consume when streaming to clients
17 MaxBandwidth 1000
18
19 # Access Log file (uses standard Apache log file format)
20 # '-' is the standard output
21 CustomLog -
22
23 # Suppress that if you want to launch ffserver as a daemon
24 NoDaemon
25
26
27 ##################################################################
28 # Definition of the live feeds. Each live feed contains one video
29 # and/or audio sequence coming from an ffmpeg encoder or another
30 # ffserver. This sequence may be encoded simultaneously with several
31 # codecs at several resolutions.
32
33 <Feed feed1.ffm>
34
35 # You must use 'ffmpeg' to send a live feed to ffserver. In this
36 # example, you can type:
37
38 # ffmpeg http://localhost:8090/feed1.ffm
39
40 # ffserver can also do time shifting. It means that it can stream any
41 # previously recorded live stream. The request should contain:
42 # "http://xxxx?date=[YYYY-MM-DDT][[HH:]MM:]SS[.m...]".You must specify
43 # a path where the feed is stored on disk. You also specify the
44 # maximum size of the feed (100M bytes here). Default:
45 # File=/tmp/feed_name.ffm FileMaxSize=5M
46 File /tmp/feed1.ffm
47 FileMaxSize 200K
48
49 # You could specify
50 # ReadOnlyFile /saved/specialvideo.ffm
51 # This marks the file as readonly and it will not be deleted or updated
52
53 # Specify launch in order to start ffmpeg automatically
54 #Launch
55
56 # Only allow connections from localhost to the feed
57 ACL allow 127.0.0.1
58
59 </Feed>
60
61
62 ##################################################################
63 # Now you can define each stream which will be generated from the
64 # original audio and video stream. Each format has a filename (here
65 # 'test1.mpg'). FFServer will send this stream when answering a
66 # request containing this filename.
67
68 <Stream test1.mpg>
69
70 # coming from live feed 'feed1'
71 Feed feed1.ffm
72
73 # Format of the stream : you can choose among:
74 # mpeg       : MPEG1 multiplexed video and audio
75 # mpegvideo  : only MPEG1 video
76 # mp2        : MPEG2 audio (use AudioCodec to select layer 2 and 3 codec)
77 # ogg        : Ogg format (Vorbis audio codec)
78 # rm         : Real Networks compatible stream. Multiplexed audio and video.
79 # ra         : Real Networks compatible stream. Audio only.
80 # mpjpeg     : Multipart JPEG (works with Netscape without any plugin)
81 # jpeg       : Generate a single JPEG image.
82 # asf_stream : ASF compatible streaming (Windows Media Player format).
83 # asf        : ASF file (not streamed)
84 # swf        : Macromedia flash(tm) compatible stream
85 # avi        : AVI format (open divx video, mpeg audio sound)
86 # master     : special ffmpeg stream used to duplicate a server
87 Format mpeg
88
89 # Bitrate for the audio stream. Codecs usually support only a few
90 # different bitrates. 
91 AudioBitRate 32
92
93 # Number of audio channels : 1 = mono, 2 = stereo
94 AudioChannels 1
95
96 # Sampling frequency for audio. When using low bitrates, you should
97 # lower this frequency to 22050 or 11025. The supported frequencies
98 # depend on the selected audio codec.
99 AudioSampleRate 44100
100
101 # Bitrate for the video stream.
102 VideoBitRate 64
103
104 # Number of frames per second
105 VideoFrameRate 3
106
107 # Size of the video frame : WxH (default: 160x128)
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 # More MPEG4 parameters
119 # VideoHighQuality
120 # Video4MotionVector
121
122 # Choose your codecs: 
123 #AudioCodec mp2
124 #VideoCodec mpeg1video
125
126 # Suppress audio
127 #NoAudio
128
129 # Suppress video
130 #NoVideo
131
132 #VideoQMin 3
133 #VideoQMax 31
134
135 # Set this to the number of seconds backwards in time to start. Note that
136 # most players will buffer 5-10 seconds of video, and also you need to allow
137 # for a key frame to appear in the data stream.
138 #PreRoll 15
139
140 # ACL:
141
142 # You can allow ranges of addresses (or single addresses)
143 #ACL ALLOW <first address> <last address>
144
145 # You can deny ranges of addresses (or single addresses)
146 #ACL DENY <first address> <last address>
147
148 # You can repeat the ACL allow/deny as often as you like. It is on a per
149 # stream basis. The first match defines the action. If there are no matches,
150 # then the default is the inverse of the last ACL statement.
151 #
152 # Thus 'ACL allow localhost' only allows access from localhost. 
153 # 'ACL deny 1.0.0.0 1.255.255.255' would deny the whole of network 1 and
154 # allow everybody else.
155
156 </Stream>
157
158
159 ##################################################################
160 # Example streams
161
162
163 # Multipart JPEG
164
165 #<Stream test.mjpg>
166 #Feed feed1.ffm
167 #Format mpjpeg
168 #VideoFrameRate 2
169 #VideoIntraOnly
170 #NoAudio
171 #</Stream>
172
173
174 # Single JPEG
175
176 #<Stream test.jpg>
177 #Feed feed1.ffm
178 #Format jpeg
179 #VideoFrameRate 2 
180 #VideoIntraOnly
181 ##VideoSize 352x240
182 #NoAudio
183 #</Stream>
184
185
186 # Flash
187
188 #<Stream test.swf>
189 #Feed feed1.ffm
190 #Format swf
191 #VideoFrameRate 2
192 #VideoIntraOnly
193 #NoAudio
194 #</Stream>
195
196
197 # ASF compatible
198
199 <Stream test.asf>
200 Feed feed1.ffm
201 Format asf
202 VideoFrameRate 15
203 VideoSize 352x240
204 VideoBitRate 256
205 VideoGopSize 30
206 AudioBitRate 64
207 StartSendOnKey
208 </Stream>
209
210
211 # MP3 audio 
212
213 #<Stream test.mp3>
214 #Feed feed1.ffm
215 #Format mp2
216 #AudioCodec mp3
217 #AudioBitRate 64
218 #AudioChannels 1
219 #AudioSampleRate 44100
220 #NoVideo
221 #</Stream>
222
223
224 # Ogg Vorbis audio
225
226 #<Stream test.ogg>
227 #Feed feed1.ffm
228 #Title "Stream title"
229 #AudioBitRate 64
230 #AudioChannels 2
231 #AudioSampleRate 44100
232 #NoVideo
233 #</Stream>
234
235
236 # Real with audio only at 32 kbits
237
238 #<Stream test.ra>
239 #Feed feed1.ffm
240 #Format rm
241 #AudioBitRate 32
242 #NoVideo
243 #NoAudio
244 #</Stream>
245
246
247 # Real with audio and video at 64 kbits
248
249 #<Stream test.rm>
250 #Feed feed1.ffm
251 #Format rm
252 #AudioBitRate 32
253 #VideoBitRate 128
254 #VideoFrameRate 25
255 #VideoGopSize 25
256 #NoAudio
257 #</Stream>
258
259
260 ##################################################################
261 # A stream coming from a file : you only need to set the input
262 # filename and optionnally a new format. Supported conversions:
263 #    avi -> asf
264
265 #<Stream file.rm>
266 #File "/usr/local/httpd/htdocs/tlive.rm"
267 #NoAudio
268 #</Stream>
269
270 #<Stream file.asf>
271 #File "/usr/local/httpd/htdocs/test.asf"
272 #NoAudio
273 #Author "Me"
274 #Copyright "Super MegaCorp"
275 #Title "Test stream from disk"
276 #Comment "Test comment"
277 #</Stream>
278
279
280 ##################################################################
281 # RTSP examples
282 #
283 # You can access to this stream with the RTSP URL:
284 #   rtsp://localhost:5454/test1-rtsp.mpg
285 #
286 # A non standard RTSP redirector is also created. Its URL is:
287 #   http://localhost:8090/test1-rtsp.rtsp
288
289 #<Stream test1-rtsp.mpg>
290 #Format rtp
291 #File "/usr/local/httpd/htdocs/test1.mpg"
292 #</Stream>
293
294
295 ##################################################################
296 # SDP/multicast examples
297 #
298 # If you want to send your stream in multicast, you must set the
299 # multicast address with MulticastAddress. The port and the TTL can
300 # also be set.
301 #
302 # An SDP file is automatically generated by ffserver by adding the
303 # 'sdp' extension to the stream name (here
304 # http://localhost:8090/test1-sdp.sdp). You should usually give this
305 # file to your player to play the stream.
306
307 # The 'NoLoop' option can be used to avoid looping when the stream is
308 # terminated.
309
310 #<Stream test1-sdp.mpg>
311 #Format rtp
312 #File "/usr/local/httpd/htdocs/test1.mpg"
313 #MulticastAddress 224.124.0.1
314 #MulticastPort 5000
315 #MulticastTTL 16
316 #NoLoop
317 #</Stream>
318
319
320 ##################################################################
321 # Special streams
322
323 # Server status
324
325 <Stream stat.html>
326 Format status
327
328 # Only allow local people to get to the status
329 ACL allow localhost
330 ACL allow 192.168.0.0 192.168.255.255
331
332 #FaviconURL http://pond1.gladstonefamily.net:8080/favicon.ico
333 </Stream>
334
335
336 # Redirect index.html to the appropriate site
337
338 <Redirect index.html>
339 URL http://ffmpeg.sourceforge.net/
340 </Redirect>
341
342