Play with ffserver - a quick overview

2013-07-04T11:04:00+02:00

Everybody knows ffmpeg the command line encoding tool but do you know ffserver ? ffserver is a multimedia streaming server for live broadcasts. With it, you can stream over HTTP, RTP and RSTP.

Quick overview

The concept is to use ffmpeg to push content to one server. This server will transcode streams and deliver to the end-users.

Input streams are called feed and for each feed you can have multiple output stream.

We can manage ffserver via a configuration file. The syntax is close to the one used for Apache server. You can find a example here. And there are more informations in the ffserver wiki.

We will see two examples on how to deliver content via a ffserver. There will be a FLV and a WebM stream.

Stream FLV

In this example, we will have one input stream and two output : one in FLV and one WebM.

Here are the general configuration settings

[code language="text"]
Port 8090
BindAddress 0.0.0.0
MaxHTTPConnections 2000
MaxClients 1000
MaxBandwidth 1000
CustomLog -
[/code]

We define a status page.

[code language="text"]
\<Stream stat.html>
Format status
ACL allow localhost
ACL allow 192.168.0.0 192.168.255.255
\</Stream>
[/code]
This page will help us to monitor the server. This page is call with this url : http://localhost:8090/stat.html and you will get this page :

Now we set up the feed : storage area, max size and allowed referrers. Remember, feeds are the input of the ffserver.
[code language="text"]
\<Feed feed1.ffm>
File /tmp/feed1.ffm
FileMaxSize 1G
ACL allow 127.0.0.1
\</Feed>
[/code]
Ok, our configuration file have now a input feed. Now, we will add the first output : the FLV one. The video will be encoded in H264 for video and AAC for audio. This part is divided in 3 part :

general settings : which feed is used and output format
settings for video
settings for audio

[code language="text"]
\<Stream live.flv>
Format flv
Feed feed1.ffm

VideoCodec libx264
VideoFrameRate 30
VideoBitRate 800
VideoSize 720x576
AVOptionVideo crf 23
AVOptionVideo preset medium
AVOptionVideo me_range 16
AVOptionVideo qdiff 4
AVOptionVideo qmin 10
AVOptionVideo qmax 51
AVOptionVideo flags +global_header

AudioCodec aac
Strict -2
AudioBitRate 128
AudioChannels 2
AudioSampleRate 44100
AVOptionAudio flags +global_header
\</Stream>
[/code]

The first part of our server is now configured and saved in a ffserver.conf file. We can test it. Launch the server with this command line :
[code language="bash"]ffserver -f ffserver.conf[/code]
You will have this output :
[code language="bash"] ffserver version 1.2.1 Copyright (c) 2000-2013 the FFmpeg developers
built on Jun 24 2013 10:41:49 with Apple clang version 4.1 (tags/Apple/clang-421.11.65) (based on LLVM 3.1svn)
configuration: --prefix=/opt/local --enable-swscale --enable-avfilter --enable-libmp3lame --enable-libvorbis --enable-libopus --enable-libtheora --enable-libschroedinger --enable-libopenjpeg --enable-libmodplug --enable-libvpx --enable-libspeex --enable-libass --enable-libbluray --enable-gnutls --enable-libfreetype --mandir=/opt/local/share/man --enable-shared --enable-pthreads --cc=/usr/bin/clang --arch=x86_64 --enable-yasm --enable-gpl --enable-postproc --enable-libx264 --enable-libxvid --enable-nonfree --enable-libfaac
libavutil 52. 18.100 / 52. 18.100
libavcodec 54. 92.100 / 54. 92.100
libavformat 54. 63.104 / 54. 63.104
libavdevice 54. 3.103 / 54. 3.103
libavfilter 3. 42.103 / 3. 42.103
libswscale 2. 2.100 / 2. 2.100
libswresample 0. 17.102 / 0. 17.102
libpostproc 52. 2.100 / 52. 2.100
Wed Jul 3 14:02:01 2013 FFserver started.
[/code]
Your server is now up and running. We can push our first movie, in my case, I use the Sintel Movie trailer. The ffmpeg command line read the video and push it to the feed we configured above.
[code language="bash"][/code]ffmpeg -i sintel.mp4 http://localhost:8090/feed1.ffm[/code]
Now you can launch your preferred player (in my case VLC) and try to stream the content : http://localhost:8090/live.flv ;-)

Stream WebM

Ok we have now one FLV output stream. We will replace FLV stream by one new output : WebM (with Vorbis and VP6). We will re-used the ffserver.conf file and put this part :

[code language="text"]
\<Stream live.webm>
Feed feed1.ffm
Format webm

AudioCodec vorbis
AudioBitRate 64

VideoCodec libvpx
VideoSize 720x576
VideoFrameRate 25
AVOptionVideo flags +global_header
AVOptionVideo cpu-used 0
AVOptionVideo qmin 10
AVOptionVideo qmax 42
AVOptionVideo quality good
AVOptionAudio flags +global_header
PreRoll 15
StartSendOnKey
VideoBitRate 400
\</Stream>
[/code]

Restart the server and push again the content. You can test the movie on Chrome or VLC with this url : http://localhost:8090/live.webm

Note: with WebM, you can create a kind of live stream if you loop on different ffmpeg command line.

To conclude, we know ffmpeg as one of the most useful free encoder. Now, ffserver is a very interesting tool and deserve more time to test the different possibility of it.
Have fun with it ! ;-)

Web, Technologies, IA, Vidéo... - Analyse, Bidouille, Streaming server, Vidéo

Play with ffserver - a quick overview

Quick overview

Stream FLV

Stream WebM