How to Install And Configure FUPPES on Ubuntu Hardy

FUPPES stands for Free UPnP Entertainment Service and is a free, multiplatform UPnP A/V Media Server that 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, which means you can play your audio/video from your PS3 and Xbox 360.

This tutorial teaches you how to install and configure FUPPES on Ubuntu Hardy-32bits

Install the dependencies

The following are some of the optional dependencies that allow you to transcode audio and video on the fly.

In your terminal,

sudo apt-get install lame liblame-dev libflac-dev libvorbis-dev ffmpeg libavformat-dev libmpcdec-dev twolame faad imagemagick

Update: If you are using Ubuntu Intrepid, the liblame-dev has been replaced by libmp3lame-dev. Thanks to Tuna for reminding.

Installing FUPPES

Download FUPPES (from GetDeb) to your desktop.

Double click the deb file to install FUPPES.

Configuring FUPPES

In your terminal, type


follow by pressing the keyboard shortcut Ctrl + C to quit the application. We are not going to run the application now. The purpose of this running and quitting is for FUPPES to generate the fuppes.cfg file.

Now, go to your Home folder (Places -> Home Folder). Press Ctrl+ H to display all the hidden folders. Navigate to .fuppes folder


Open fuppes.cfg with text editor.


Search for

<!–empty = automatic detection–>
<!–empty or 0 = random port–>
<!–list of ip addresses allowed to access fuppes. if empty all ips are allowed–>

and replace with

<!–empty = automatic detection–>
<!–empty or 0 = random port–>
<!–list of ip addresses allowed to access fuppes. if empty all ips are allowed–>

Remember to change YOUR-IP-ADDRESS to your own IP address. Alternatively, you can use your network interface, such as wlan0 or eth0 such as the interface name.


Save and exit.

Back to your terminal, run FUPPES again by typing


Open your browser and navigate to http://your-ip-address:5080. You should see the FUPPES main screen

fuppes in browser

On the left, click Configuration.

In the Add objects field, specify the path to the media folder that you want to share. Click Submit Query.


Once you are done adding your media folder, click Options on the left. Click rebuild database


You are now good to go.

Testing it out

Since XBMC has the ability to stream media over a network via a uPnP, we will use it to test out the FUPPES configuration. Follow this tutorial to install XBMC.

Open your XBMC (Applications -> Sound & Videos -> XBMC Media Center)

On the left, click on Music follow by Add Source


Click Browse and scroll down to uPnP Device


If your FUPPES is successful, you will see the entry on the list. You might have to try a few times to get XBMC to detect the media server.


You can then click OK to add the source and enjoy the music in the XBMC player. If you have .flac files, it will be transcoded to .mp3 when you play it in XBMC.

Configure FUPPES to start everytime you boot up

Go to System -> Preferences -> Sessions. In the Startup Programs tab, click Add. Enter the following detail:


Click OK.

Done. FUPPES will start automatically the next time you boot up.

Accessing FUPPES from PS3 and Xbox 360

I don’t have a PS3 and Xbox 360 to test. Here are some resources for your reference

Fuppes wiki – Microsoft Xbox 360

Fuppes wiki – Playstation 3

Fuppes wiki – Device specific setting



  1. thank you so mch… i really love your site. im learning so mch about linux from you.
    again i thank you and keep it up!!!


  2. can you help me make me transcode my kmv files? ive been through the wiki and i cannot make mkv files to work. the forums are not replying… i hope you can help me on this. thanks!

  3. can you help me make me transcode my kmv files? ive been through the wiki and i cannot make mkv files to work. the forums are not replying… i hope you can help me on this. thanks!

  4. In Ubuntu Intrepid liblame-dev has been replaced by libmp3lame-dev

    1. Thanks. I have updated the post.

      1. where’s the updated post?

  5. All,

    I am getting this error when installing FUPPES in Ubuntu Intrepid:

    Error: Dependancy is not satisfiable: libavcodecId

    ************ Any ideas ?!!! ***********

    1. Thanks to RATSat on this forum, I got the dependencies working.

      Download and install libavcodec1d libavformat1d libavutil1d (the third one I needed, I don’t know if you will) from (sorry for the lack of a direct link):

      Then it should work.

  6. When I change the http_port to 5080, I get this error.

    /home/kyle/.fuppes/fuppes.cfg:216: parser error : Opening and ending tag mismatch: fuppes_config line 2 and device_settings

    /home/kyle/.fuppes/fuppes.cfg:217: parser error : Extra content at the end of the document

    == lib/SharedConfig.cpp (390) :: Wed Jan 14 20:16:57 2009 ==
    parse error.

  7. Ubuntu newbie in need of help :P
    When i try the line…
    libmp3lame-dev twolame faad imagemagick

    I keep getting bash: libmp3lame-dev: command not found

    I have tried the following to install it:
    bash: libmp3lame-dev: command not found

    Any ideas of what this could be?

    1. sukhsc,

      type “sudo apt-get install libmp3lame-dev twolame faad imagemagick” to install those files. If you are using Intrepid as am I, then you will need to download and install the 3 files as listed by kyle in order for fuppes to be installed. In my experience, install utils, then codec, then format in that order. Good Luck!

  8. I get the following error when installing on ubuntu 8.04 server

    process 4969: D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open “/var/lib/dbus/machine-id”: No such file or directory
    See the manual page for dbus-uuidgen to correct this issue.
    libnotify-Message: Unable to get session bus: Failed to execute dbus-launch to autolaunch D-Bus session
    notify_init() failed
    FUPPES – SVN-r578
    the Free UPnP Entertainment Service

    == lib/ContentDirectory/VirtualContainerMgr.cpp (54) :: Tue Jan 27 10:02:47 2009 ==
    no vfolder.cfg file available

    and this directory is not there, but I don’t know what was suppose to be there, also I had to install the package dpkg -i fuppes.blabla.deb (I don’t know the exact package name)

    1. I am getting the same error now. I have had this working for over a year, but now I am getting this error.

      Were you able to figure out what the problem was?

  9. I keep getting the dependency error libcairo2, I went to synaptic and installed all of the libcairo2 dependencies but it is still coming up with the error. Any Ideas??

    1. never mind got the dep.

  10. So now i am trying to do the part where i put my ip adress in the browser but it keeps timing out. any suggestions?

  11. when i try to start fuppes i keep getting this message,

    chris@chris-laptop:~$ fuppes
    FUPPES – SVN-r578
    the Free UPnP Entertainment Service

    [ERROR] failed to bind socket to :
    any idea

  12. I am trying to install it on ubuntu jaunty, but am not getting any joy. it needs libmagick++10 but there isnt one for jaunty.

    any ideas?

Comments are closed.