swresample/swresample: fix sample drop loop end condition
[ffmpeg.git] / doc / ffserver.conf
index 794e63c..094c093 100644 (file)
@@ -1,5 +1,5 @@
 # Port on which the server is listening. You must select a different
-# port from your standard http web server if it is running on the same
+# port from your standard HTTP web server if it is running on the same
 # computer.
 Port 8090
 
@@ -7,23 +7,24 @@ Port 8090
 # several network interfaces.
 BindAddress 0.0.0.0
 
+# Number of simultaneous HTTP connections that can be handled. It has
+# to be defined *before* the MaxClients parameter, since it defines the
+# MaxClients maximum limit.
+MaxHTTPConnections 2000
+
 # Number of simultaneous requests that can be handled. Since FFServer
 # is very fast, it is more likely that you will want to leave this high
 # and use MaxBandwidth, below.
 MaxClients 1000
 
 # This the maximum amount of kbit/sec that you are prepared to
-# consume when streaming to clients
+# consume when streaming to clients.
 MaxBandwidth 1000
 
-# Access Log file (uses standard Apache log file format)
-# '-' is the standard output
+# Access log file (uses standard Apache log file format)
+# '-' is the standard output.
 CustomLog -
 
-# Suppress that if you want to launch ffserver as a daemon
-NoDaemon
-
-
 ##################################################################
 # Definition of the live feeds. Each live feed contains one video
 # and/or audio sequence coming from an ffmpeg encoder or another
@@ -34,26 +35,28 @@ NoDaemon
 
 # You must use 'ffmpeg' to send a live feed to ffserver. In this
 # example, you can type:
-# 
+#
 # ffmpeg http://localhost:8090/feed1.ffm
 
 # ffserver can also do time shifting. It means that it can stream any
 # previously recorded live stream. The request should contain:
 # "http://xxxx?date=[YYYY-MM-DDT][[HH:]MM:]SS[.m...]".You must specify
 # a path where the feed is stored on disk. You also specify the
-# maximum size of the feed (100M bytes here). Default:
+# maximum size of the feed, where zero means unlimited. Default:
 # File=/tmp/feed_name.ffm FileMaxSize=5M
 File /tmp/feed1.ffm
 FileMaxSize 200K
 
 # You could specify
 # ReadOnlyFile /saved/specialvideo.ffm
-# This marks the file as readonly and it will not be deleted or updated
+# This marks the file as readonly and it will not be deleted or updated.
 
-# Specify launch in order to start ffmpeg automatically
-#Launch
+# Specify launch in order to start ffmpeg automatically.
+# First ffmpeg must be defined with an appropriate path if needed,
+# after that options can follow, but avoid adding the http:// field
+#Launch ffmpeg
 
-# Only allow connections from localhost to the feed
+# Only allow connections from localhost to the feed.
 ACL allow 127.0.0.1
 
 </Feed>
@@ -71,25 +74,24 @@ ACL allow 127.0.0.1
 Feed feed1.ffm
 
 # Format of the stream : you can choose among:
-# mpeg       : MPEG1 multiplexed video and audio
-# mpegvideo  : only MPEG1 video
-# mp2        : MPEG2 audio (use AudioCodec to select layer 2 and 3 codec)
+# mpeg       : MPEG-1 multiplexed video and audio
+# mpegvideo  : only MPEG-1 video
+# mp2        : MPEG-2 audio (use AudioCodec to select layer 2 and 3 codec)
 # ogg        : Ogg format (Vorbis audio codec)
-# rm         : Real Networks compatible stream. Multiplexed audio and video.
-# ra         : Real Networks compatible stream. Audio only.
+# rm         : RealNetworks-compatible stream. Multiplexed audio and video.
+# ra         : RealNetworks-compatible stream. Audio only.
 # mpjpeg     : Multipart JPEG (works with Netscape without any plugin)
 # jpeg       : Generate a single JPEG image.
 # asf        : ASF compatible streaming (Windows Media Player format).
-# swf        : Macromedia flash(tm) compatible stream
-# avi        : AVI format (open divx video, mpeg audio sound)
-# master     : special ffmpeg stream used to duplicate a server
+# swf        : Macromedia Flash compatible stream
+# avi        : AVI format (MPEG-4 video, MPEG audio sound)
 Format mpeg
 
 # Bitrate for the audio stream. Codecs usually support only a few
-# different bitrates. 
+# different bitrates.
 AudioBitRate 32
 
-# Number of audio channels : 1 = mono, 2 = stereo
+# Number of audio channels: 1 = mono, 2 = stereo
 AudioChannels 1
 
 # Sampling frequency for audio. When using low bitrates, you should
@@ -97,28 +99,34 @@ AudioChannels 1
 # depend on the selected audio codec.
 AudioSampleRate 44100
 
-# Bitrate for the video stream.
+# Bitrate for the video stream
 VideoBitRate 64
 
+# Ratecontrol buffer size
+VideoBufferSize 40
+
 # Number of frames per second
 VideoFrameRate 3
 
-# Size of the video frame : WxH (default: 160x128)
-# The following abbreviation are defined : sqcif, qcif, cif, 4cif
+# Size of the video frame: WxH (default: 160x128)
+# The following abbreviations are defined: sqcif, qcif, cif, 4cif, qqvga,
+# qvga, vga, svga, xga, uxga, qxga, sxga, qsxga, hsxga, wvga, wxga, wsxga,
+# wuxga, woxga, wqsxga, wquxga, whsxga, whuxga, cga, ega, hd480, hd720,
+# hd1080
 VideoSize 160x128
 
-# transmit only intra frames (useful for low bitrates, but kills frame rate) 
+# Transmit only intra frames (useful for low bitrates, but kills frame rate).
 #VideoIntraOnly
 
-# If non intra only, an intra frame is transmitted every VideoGopSize
-# frames Video synchronization can only begin at an I frames.
+# If non-intra only, an intra frame is transmitted every VideoGopSize
+# frames. Video synchronization can only begin at an intra frame.
 VideoGopSize 12
 
-# More MPEG4 parameters
+# More MPEG-4 parameters
 # VideoHighQuality
 # Video4MotionVector
 
-# Choose your codecs: 
+# Choose your codecs:
 #AudioCodec mp2
 #VideoCodec mpeg1video
 
@@ -133,8 +141,8 @@ VideoGopSize 12
 
 # Set this to the number of seconds backwards in time to start. Note that
 # most players will buffer 5-10 seconds of video, and also you need to allow
-# for a key frame to appear in the data stream.
-#PreRoll 15
+# for a keyframe to appear in the data stream.
+#Preroll 15
 
 # ACL:
 
@@ -148,7 +156,7 @@ VideoGopSize 12
 # stream basis. The first match defines the action. If there are no matches,
 # then the default is the inverse of the last ACL statement.
 #
-# Thus 'ACL allow localhost' only allows access from localhost. 
+# Thus 'ACL allow localhost' only allows access from localhost.
 # 'ACL deny 1.0.0.0 1.255.255.255' would deny the whole of network 1 and
 # allow everybody else.
 
@@ -167,6 +175,7 @@ VideoGopSize 12
 #VideoFrameRate 2
 #VideoIntraOnly
 #NoAudio
+#Strict -1
 #</Stream>
 
 
@@ -175,10 +184,11 @@ VideoGopSize 12
 #<Stream test.jpg>
 #Feed feed1.ffm
 #Format jpeg
-#VideoFrameRate 2 
+#VideoFrameRate 2
 #VideoIntraOnly
 ##VideoSize 352x240
 #NoAudio
+#Strict -1
 #</Stream>
 
 
@@ -201,13 +211,14 @@ Format asf
 VideoFrameRate 15
 VideoSize 352x240
 VideoBitRate 256
+VideoBufferSize 40
 VideoGopSize 30
 AudioBitRate 64
 StartSendOnKey
 </Stream>
 
 
-# MP3 audio 
+# MP3 audio
 
 #<Stream test.mp3>
 #Feed feed1.ffm
@@ -224,7 +235,7 @@ StartSendOnKey
 
 #<Stream test.ogg>
 #Feed feed1.ffm
-#Title "Stream title"
+#Metadata title "Stream title"
 #AudioBitRate 64
 #AudioChannels 2
 #AudioSampleRate 44100
@@ -257,9 +268,9 @@ StartSendOnKey
 
 
 ##################################################################
-# A stream coming from a file : you only need to set the input
-# filename and optionnally a new format. Supported conversions:
-#    avi -> asf
+# A stream coming from a file: you only need to set the input
+# filename and optionally a new format. Supported conversions:
+#    AVI -> ASF
 
 #<Stream file.rm>
 #File "/usr/local/httpd/htdocs/tlive.rm"
@@ -269,20 +280,20 @@ StartSendOnKey
 #<Stream file.asf>
 #File "/usr/local/httpd/htdocs/test.asf"
 #NoAudio
-#Author "Me"
-#Copyright "Super MegaCorp"
-#Title "Test stream from disk"
-#Comment "Test comment"
+#Metadata author "Me"
+#Metadata copyright "Super MegaCorp"
+#Metadata title "Test stream from disk"
+#Metadata comment "Test comment"
 #</Stream>
 
 
 ##################################################################
 # RTSP examples
 #
-# You can access to this stream with the RTSP URL:
+# You can access this stream with the RTSP URL:
 #   rtsp://localhost:5454/test1-rtsp.mpg
 #
-# A non standard RTSP redirector is also created. Its URL is:
+# A non-standard RTSP redirector is also created. Its URL is:
 #   http://localhost:8090/test1-rtsp.rtsp
 
 #<Stream test1-rtsp.mpg>
@@ -291,6 +302,27 @@ StartSendOnKey
 #</Stream>
 
 
+# Transcode an incoming live feed to another live feed,
+# using libx264 and video presets
+
+#<Stream live.h264>
+#Format rtp
+#Feed feed1.ffm
+#VideoCodec libx264
+#VideoFrameRate 24
+#VideoBitRate 100
+#VideoSize 480x272
+#AVPresetVideo default
+#AVPresetVideo baseline
+#AVOptionVideo flags +global_header
+#
+#AudioCodec libfaac
+#AudioBitRate 32
+#AudioChannels 2
+#AudioSampleRate 22050
+#AVOptionAudio flags +global_header
+#</Stream>
+
 ##################################################################
 # SDP/multicast examples
 #
@@ -302,7 +334,7 @@ StartSendOnKey
 # 'sdp' extension to the stream name (here
 # http://localhost:8090/test1-sdp.sdp). You should usually give this
 # file to your player to play the stream.
-# 
+#
 # The 'NoLoop' option can be used to avoid looping when the stream is
 # terminated.
 
@@ -324,7 +356,7 @@ StartSendOnKey
 <Stream stat.html>
 Format status
 
-# Only allow local people to get to the status
+# Only allow local people to get the status
 ACL allow localhost
 ACL allow 192.168.0.0 192.168.255.255
 
@@ -335,7 +367,5 @@ ACL allow 192.168.0.0 192.168.255.255
 # Redirect index.html to the appropriate site
 
 <Redirect index.html>
-URL http://ffmpeg.sourceforge.net/
+URL http://www.ffmpeg.org/
 </Redirect>
-
-