INSTALATION
-----------
We are going to install the GIT version of FFmpeg in $HOME/ff, the latest
version is always prefered as development goes pretty rapid in FFmpeg world.


This instalation is tested under FreeBSD:
  # Compile all required packages
  $ sudo make -C /usr/ports/lang/clang -DBATCH=yes -DWITHOUT_X11=yes install
  $ sudo make -C /usr/ports/multimedia/x264 -DBATCH=yes -DWITHOUT_X11=yes install
  $ sudo make -C /usr/ports/devel/git -DBATCH=yes -DWITHOUT_X11=yes install
  $ sudo make -C /usr/ports/devel/subversion -DBATCH=yes -DWITHOUT_X11=yes install

  $ sudo make -C /usr/ports/devel/py-daemon -DBATCH=yes -DWITHOUT_X11=yes install
  # The stock version of py-lockfile is broken using a local modified version as override

  # Checkout FFmpeg
  $ mkdir $HOME/src
  $ git clone git://source.ffmpeg.org/ffmpeg.git $HOME/src/ffmpeg

  # Compile FFmpeg
  $ cd $HOME/src/ffmpeg
  $ env CFLAGS="-I/usr/local/include -l/usr/local/lib" ./configure --cc=clang \
    --cxx=clang --ld=clang --enable-libx264 --enable-gpl --prefix=$HOME/ff/
  $ env CFLAGS="-I/usr/local/include -l/usr/local/lib" gmake install

  # Checkout FFmpeg C&C
  $ svn co http://svn.wirelessleiden.nl/svn/projects/webcams/ffmpeg-control $HOME/ffmpeg-control

  # Now modify create your own config files, the authentication could be done
  # in a seperate file to avoid having to store your username/password details
  # of your camera in your version control system. 
  $ cd $HOME/ffmpeg-control
  $ vim ffmpeg-cams.cfg 
  $ cp ffmpeg-auth.cfg.tmpl ffmpeg-auth.cfg
  $ vim ffmpeg-auth.cfg



RUNNING
-------
Starting ffmpeg-control will start your server and streaming clients, limits
depends our the hardware you use. You wil find the log files for all individual
streams and your master config at your var directory:
  $HOME/ffmpeg-control/var


TROUBLESHOOTING
---------------
This few tips could help you troubleshoot failing setups:
  * Look at the logfiles (seriously!).
  * Look at the output of ffprobe on your source URL to verify you have the
    right frame-rates/width/height/codec/etc...
  * Send an email to the list below, explaining your issue. Make sure we can
  * access your camera stream to allow debugging.



FEEDBACK & QUESTIONS
--------------------
Techniek Wireless Leiden Mailinglist <techniek@lijst.wirelessleiden.nl>
Rick van der Zwet <info@rickvanderzwet.nl>