Introduction ============ Welcome to, and thankyou for downloading, FUPPES (Free UPnP Entertainment Service)! FUPPES is a free, multiplatform UPnP A/V Media Server. FUPPES supports a wide range of UPnP MediaRenderers as well as on-the-fly transcoding of various audio, video and image formats. FUPPES also includes basic DLNA support. For more developer or user information visit the wiki: https://bitbucket.org/robertmassaioli/fuppes/wiki Basic Installation ================== CMake Build ----------- You can use cmake to build fuppes. You can do that by:: ./scripts/prepare_cmake.bash make -C localbuild make -C localbuild install GNU Automake ------------ FUPPES uses standard GNU automake and as such all it requires to install is a:: autoreconf -vfi # step 1 ./configure # step 2 make # step 3 make install # step 4 It should be noted that before step 2 you may like to try './configure --help' to see what your options are and then run './configure' with the options that you want. And on Debian based systems you will likely need to prefix the 'sudo' command to the 'make install' so that it will run with the right privileges. Security Notice =============== The only times that fuppes will require 'root' priveliges are: 1. When you are dealing with the init.d script to start and stop fuppes. 1. When you are installing a packaged version of fuppes. Fuppes itself should not run as root, just the package installer. 1. When you run the 'make install' command. For security reasons fuppes should never EVER be run as the root user. If you notice the pattern above, you may need to be the root user to start and stop fuppes but you should never run the actual fuppes executable as the root user. *NOTE:* This file must be called README and not README.rst because automake tools expect there to be a file present called README and I do not want to maintain two separate readme files. In the future, if for some reason we ever drop autotools, then we can change this file to use whatever format we please.