diff --git a/doc/ffmpeg-doc.texi b/doc/ffmpeg-doc.texi index de287ace0e..9b37c180ba 100644 --- a/doc/ffmpeg-doc.texi +++ b/doc/ffmpeg-doc.texi @@ -402,8 +402,8 @@ solutions. @tab MP3 encoding is supported thru the external library LAME @item AC3 @tab IX @tab X @tab liba52 is used internally for decoding. -@item Vorbis @tab X @tab -@tab encoding is supported thru the external library libvorbis. +@item Vorbis @tab X @tab X +@tab supported thru the external library libvorbis. @item WMA V1/V2 @tab @tab X @end multitable @@ -447,7 +447,7 @@ that ffmpeg negates when returning. This ends up turning errors into valid results, then crashes. (To be fixed) -@chapter Developpers Guide +@chapter Developers Guide @section API @itemize diff --git a/doc/ffserver.conf b/doc/ffserver.conf index 29cf7800d8..7aa87aeb16 100644 --- a/doc/ffserver.conf +++ b/doc/ffserver.conf @@ -1,33 +1,29 @@ # 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 # computer. - Port 8090 # Address on which the server is bound. Only useful if you have # several network interfaces. - BindAddress 0.0.0.0 # Number of simultaneous requests that can be handled. Since FFServer -# is very fast, this limit is determined mainly by your Internet -# connection speed. - +# 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 - MaxBandwidth 1000 # 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 @@ -47,22 +43,22 @@ NoDaemon # a path where the feed is stored on disk. You also specify the # maximum size of the feed (100M bytes here). Default: # File=/tmp/feed_name.ffm FileMaxSize=5M - File /tmp/feed1.ffm FileMaxSize 200K # Specify launch in order to start ffmpeg automatically -# Launch +#Launch # Only allow connections from localhost to the feed ACL allow 127.0.0.1 + ################################################################## # Now you can define each stream which will be generated from the # original audio and video stream. Each format has a filename (here -# 'test128.mpg'). FFServer will send this stream when answering a +# 'test1.mpg'). FFServer will send this stream when answering a # request containing this filename. @@ -73,31 +69,28 @@ Feed feed1.ffm # Format of the stream : you can choose among: # mpeg : MPEG1 multiplexed video and audio # mpegvideo : only MPEG1 video -# mp2 : MPEG audio layer 2 -# mp3 : MPEG audio layer 3 (currently sent as layer 2) +# mp2 : MPEG2 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. # mpjpeg : Multipart JPEG (works with Netscape without any plugin) # jpeg : Generate a single JPEG image. -# asf : ASF compatible stream (Windows Media Player format). Not finished yet. +# asf : ASF compatible stream (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 - Format mpeg -# Bitrate for the audio stream. Codecs usually support only a few different bitrates. - +# Bitrate for the audio stream. Codecs usually support only a few +# different bitrates. AudioBitRate 32 # Number of audio channels : 1 = mono, 2 = stereo - AudioChannels 1 # Sampling frequency for audio. When using low bitrates, you should # lower this frequency to 22050 or 11025. The supported frequencies # depend on the selected audio codec. - AudioSampleRate 44100 # Bitrate for the video stream. @@ -107,9 +100,8 @@ VideoBitRate 64 VideoFrameRate 3 # Size of the video frame : WxH (default: 160x128) -# W : width, H : height # The following abbreviation are defined : sqcif, qcif, cif, 4cif -VideoSize 160x128 +VideoSize 160x128 # transmit only intra frames (useful for low bitrates, but kills frame rate) #VideoIntraOnly @@ -119,7 +111,6 @@ VideoSize 160x128 VideoGopSize 12 # Choose your codecs: - #AudioCodec mp2 #VideoCodec mpeg1video @@ -140,209 +131,161 @@ VideoGopSize 12 # ACL: # You can allow ranges of addresses (or single addresses) -# ACL ALLOW +#ACL ALLOW # You can deny ranges of addresses (or single addresses) -# ACL DENY +#ACL DENY -# You can repeat the ACL allow/deny as often as you like. It is on a per 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. -# 'ACL deny 1.0.0.0 1.255.255.255' would deny the whole of network 1 and allow everybody else. +# You can repeat the ACL allow/deny as often as you like. It is on a per +# 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. +# 'ACL deny 1.0.0.0 1.255.255.255' would deny the whole of network 1 and +# allow everybody else. -# second mpeg stream with high frame rate -# +################################################################## +# Example streams + + +# Multipart JPEG + +# #Feed feed1.ffm -#Format mpegvideo -#VideoBitRate 128 -#VideoFrameRate 25 -###VideoSize 352x240 -#VideoGopSize 25 +#Format mpjpeg +#VideoFrameRate 2 +#VideoIntraOnly #NoAudio # -# -################################################################## -# A stream coming from a file : you only need to set the input -# filename and optionnally a new format. Supported conversions: -# avi -> asf -# -# another file streaming - -File "/usr/local/httpd/htdocs/tlive.rm" -NoAudio +# Single JPEG - +# +#Feed feed1.ffm +#Format jpeg +#VideoFrameRate 2 +#VideoIntraOnly +##VideoSize 352x240 +#NoAudio +# - -File "/usr/local/httpd/htdocs/test.asf" -NoAudio -Author "Me" -Copyright "Super MegaCorp" -Title "Test stream from disk" -Comment "Test comment" +# Flash - +# +#Feed feed1.ffm +#Format swf +#VideoFrameRate 2 +#VideoIntraOnly +#NoAudio +# -################################################################## -# Another stream : Real with audio only at 32 kbits - +# ASF compatible -Feed feed1.ffm -Format rm -AudioBitRate 32 -NoVideo -NoAudio +# +#Feed feed1.ffm +#Format asf +#VideoFrameRate 15 +#VideoSize 352x240 +#VideoBitRate 256 +#VideoGopSize 30 +#AudioBitRate 64 +#StartSendOnKey +# - -################################################################## -# Another stream : Real with audio and video at 64 kbits +# MP3 audio -# +# +#Feed feed1.ffm +#Format mp2 +#AudioCodec mp3 +#AudioBitRate 64 +#AudioChannels 1 +#AudioSampleRate 44100 +#NoVideo +# + +# Ogg Vorbis audio + +# +#Feed feed1.ffm +#Title "Stream title" +#AudioBitRate 64 +#AudioChannels 2 +#AudioSampleRate 44100 +#NoVideo +# + + +# Real with audio only at 32 kbits + +# #Feed feed1.ffm #Format rm +#AudioBitRate 32 +#NoVideo +#NoAudio +# + +# Real with audio and video at 64 kbits + +# +#Feed feed1.ffm +#Format rm #AudioBitRate 32 #VideoBitRate 128 #VideoFrameRate 25 #VideoGopSize 25 #NoAudio - # - - -Feed feed1.ffm -Format rm - -VideoBitRate 128 -VideoFrameRate 15 -VideoGopSize 25 -VideoSize 320x240 -AudioBitRate 64 - - ################################################################## -# Another stream : Multipart JPEG +# A stream coming from a file : you only need to set the input +# filename and optionnally a new format. Supported conversions: +# avi -> asf -# -# -#Feed feed1.ffm -#Format mpjpeg -# -#VideoFrameRate 2 -#VideoIntraOnly +# +#File "/usr/local/httpd/htdocs/tlive.rm" #NoAudio -# # -################################################################## -# Another stream : Multipart JPEG - -# -# -#Feed feed1.ffm -#Format jpeg -# -## the parameters are choose here to take the same output as the -## Multipart JPEG one. -#VideoFrameRate 2 -#VideoIntraOnly -##VideoSize 352x240 +# +#File "/usr/local/httpd/htdocs/test.asf" #NoAudio -# +#Author "Me" +#Copyright "Super MegaCorp" +#Title "Test stream from disk" +#Comment "Test comment" # -################################################################## -# Another stream : Flash - -# - -#Feed feed1.ffm -#Format swf -# -#VideoFrameRate 2 -#VideoIntraOnly -#NoAudio -# -# - - -################################################################## -# Another stream : ASF compatible - - - -Feed feed1.ffm -Format asf -# -VideoFrameRate 15 -VideoSize 352x240 -VideoBitRate 256 -VideoGopSize 30 -AudioBitRate 64 -StartSendOnKey - - - - - -Feed feed1.ffm -Format asf -# -VideoFrameRate 15 -VideoSize 352x240 -VideoBitRate 256 -VideoGopSize 30 -NoAudio -StartSendOnKey - - - - - -Feed feed1.ffm -Format asf -# -VideoFrameRate 15 -VideoSize 352x240 -VideoBitRate 128 -VideoGopSize 30 -NoAudio -StartSendOnKey - - ################################################################## # RTSP examples - -# You can access to this stream with the RTSP URL: # -# rtsp://localhost:5454/test1-rtsp.mpg +# You can access to this stream with the RTSP URL: +# rtsp://localhost:5454/test1-rtsp.mpg # # A non standard RTSP redirector is also created. Its URL is: -# -# http://localhost:8090/test1-rtsp.rtsp -# +# http://localhost:8090/test1-rtsp.rtsp + # -# #Format rtp #File "/usr/local/httpd/htdocs/test1.mpg" -# # + ################################################################## # SDP/multicast examples - +# # If you want to send your stream in multicast, you must set the # multicast address with MulticastAddress. The port and the TTL can # also be set. @@ -354,36 +297,37 @@ StartSendOnKey # # The 'NoLoop' option can be used to avoid looping when the stream is # terminated. -# + # -# #Format rtp #File "/usr/local/httpd/htdocs/test1.mpg" #MulticastAddress 224.124.0.1 #MulticastPort 5000 #MulticastTTL 16 #NoLoop -# # + ################################################################## -# Special stream : server status +# Special streams + +# Server status - Format status # Only allow local people to get to the status - ACL allow localhost ACL allow 192.168.0.0 192.168.255.255 -FaviconURL http://pond1.gladstonefamily.net:8080/favicon.ico - +#FaviconURL http://pond1.gladstonefamily.net:8080/favicon.ico +# Redirect index.html to the appropriate site + -# maps index.html to the appropriate site URL http://ffmpeg.sourceforge.net/ + +