01506a6a170a4e88cc296d37c802803d74cc1deb
[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 50M
50
51 </Feed>
52
53 ##################################################################
54 # Now you can define each stream which will be generated from the
55 # original audio and video stream. Each format has a filename (here
56 # 'test128.mpg'). FFServer will send this stream when answering a
57 # request containing this filename.
58
59 <Stream test1.mpg>
60
61 # coming from live feed 'feed1'
62 Feed feed1.ffm
63
64 # Format of the stream : you can choose among:
65 # mpeg       : MPEG1 multiplexed video and audio
66 # mpegvideo  : only MPEG1 video
67 # mp2        : MPEG audio layer 2
68 # mp3        : MPEG audio layer 3 (currently sent as layer 2)
69 # rm         : Real Networks compatible stream. Multiplexed audio and video.
70 # ra         : Real Networks compatible stream. Audio only.
71 # mpjpeg     : Multipart JPEG (works with Netscape without any plugin)
72 # jpeg       : Generate a single JPEG image.
73 # asf        : ASF compatible stream (Windows Media Player format). Not finished yet.
74 # swf        : Macromedia flash(tm) compatible stream
75 # avi        : AVI format (open divx video, mpeg audio sound)
76 # master     : special ffmpeg stream used to duplicate a server
77
78 Format mpeg
79
80 # Bitrate for the audio stream. Codecs usually support only a few different bitrates. 
81
82 AudioBitRate 32
83
84 # Number of audio channels : 1 = mono, 2 = stereo
85
86 AudioChannels 1
87
88 # Sampling frequency for audio. When using low bitrates, you should
89 # lower this frequency to 22050 or 11025. The supported frequencies
90 # depend on the selected audio codec.
91
92 AudioSampleRate 44100
93
94 # Bitrate for the video stream.
95 VideoBitRate 64
96
97 # Number of frames per second
98 VideoFrameRate 3
99
100 # Size of the video frame : WxH (default: 160x128)
101 # W : width, H : height
102 # The following abbreviation are defined : sqcif, qcif, cif, 4cif
103 VideoSize    160x128
104
105 # transmit only intra frames (useful for low bitrates, but kills frame rate) 
106 #VideoIntraOnly
107
108 # If non intra only, an intra frame is transmitted every VideoGopSize
109 # frames Video synchronization can only begin at an I frames.
110 VideoGopSize 12
111
112 # Choose your codecs: 
113
114 #AudioCodec mp2
115 #VideoCodec mpeg1video
116
117 # Suppress audio
118 #NoAudio
119
120 # Suppress video
121 #NoVideo
122
123 #VideoQMin 3
124 #VideoQMax 31
125
126 # Set this to the number of seconds backwards in time to start. Note that
127 # most players will buffer 5-10 seconds of video, and also you need to allow
128 # for a key frame to appear in the data stream.
129 #PreRoll 15
130
131 </Stream>
132
133 # second mpeg stream with high frame rate
134
135 #<Stream test2.mpg>
136 #Feed feed1.ffm
137 #Format mpegvideo
138 #VideoBitRate 128
139 #VideoFrameRate 25
140 ###VideoSize    352x240
141 #VideoGopSize 25
142 #NoAudio
143 #</Stream>
144 #
145 ##################################################################
146 # A stream coming from a file : you only need to set the input
147 # filename and optionnally a new format. Supported conversions:
148 #    avi -> asf
149 #
150
151 # another file streaming
152 <Stream file.rm>
153
154 File "/usr/local/httpd/htdocs/tlive.rm"
155 NoAudio
156
157 </Stream>
158
159 <Stream file.asf>
160
161 File "/usr/local/httpd/htdocs/test.asf"
162 NoAudio
163
164 </Stream>
165
166 ##################################################################
167 # Another stream : Real with audio only at 32 kbits
168
169 <Stream test.ra>
170
171 Feed feed1.ffm
172 Format rm
173 AudioBitRate 32
174 NoVideo
175 NoAudio
176
177 </Stream>
178
179 ##################################################################
180 # Another stream : Real with audio and video at 64 kbits
181
182 #<Stream test.rm>
183
184 #Feed feed1.ffm
185 #Format rm
186
187 #AudioBitRate 32
188 #VideoBitRate 128
189 #VideoFrameRate 25
190 #VideoGopSize 25
191 #NoAudio
192
193 #</Stream>
194
195 <Stream test2.rm>
196
197 Feed feed1.ffm
198 Format rm
199
200 VideoBitRate 128
201 VideoFrameRate 15
202 VideoGopSize 25
203 VideoSize    320x240
204 AudioBitRate 64
205
206 </Stream>
207
208 ##################################################################
209 # Another stream : Multipart JPEG
210
211 #<Stream test.mjpg>
212 #
213 #Feed feed1.ffm
214 #Format mpjpeg
215 #
216 #VideoFrameRate 2
217 #VideoIntraOnly
218 #NoAudio
219 #
220 #</Stream>
221
222 ##################################################################
223 # Another stream : Multipart JPEG
224
225 #<Stream test.jpg>
226 #
227 #Feed feed1.ffm
228 #Format jpeg
229 #
230 ## the parameters are choose here to take the same output as the
231 ## Multipart JPEG one.
232 #VideoFrameRate 2 
233 #VideoIntraOnly
234 ##VideoSize 352x240
235 #NoAudio
236 #
237 #</Stream>
238
239 ##################################################################
240 # Another stream : Flash
241
242 #<Stream test.swf>
243
244 #Feed feed1.ffm
245 #Format swf
246 #
247 #VideoFrameRate 2
248 #VideoIntraOnly
249 #NoAudio
250 #
251 #</Stream>
252
253
254 ##################################################################
255 # Another stream : ASF compatible
256
257 <Stream test.asf>
258
259 Feed feed1.ffm
260 Format asf
261 #
262 VideoFrameRate 15
263 VideoSize 352x240
264 VideoBitRate 128
265 VideoGopSize 30
266 AudioBitRate 64
267
268 </Stream>
269
270 ##################################################################
271 # Special stream : server status
272
273 <Stream stat.html>
274
275 Format status
276
277 </Stream>