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