documentation

This document is outdated. Please take a look at the wiki for an up-to-date description.

Configuration

fuppes is completely configurable via its webinterface. Of course you can still edit the config file manually. Make sure to save the config file in UTF-8 encoding.

a clean fuppes 0.7.1 config looks like this: (without comments)

<?xml version="1.0" encoding="UTF-8"?>
<fuppes_config version="0.7">

  <shared_directories/>

  <network_settings>
    <ip_address/>
    <http_port/>
    <allowed_ips>
    </allowed_ips>
  </network_settings>

  <content_directory>
    <local_charset>UTF-8</local_charset>
    <max_file_name_length>0</max_file_name_length>
    <playlist_representation>file</playlist_representation>
  </content_directory>

  <transcoding_settings>
    <audio_encoder>lame</audio_encoder>
    <transcode_vorbis>true</transcode_vorbis>
    <transcode_musepack>true</transcode_musepack>
    <transcode_flac>true</transcode_flac>
  </transcoding_settings>

</fuppes_config>

shared_directories

list all directories that fuppes should share.
add a "dir" node for each directory. e.g.

  <shared_directories>
    <dir>/mnt/my music</dir>
    <dir>/mnt/videos</dir>
  </shared_directories>

you don't need to escape whitespaces.

network_settings

set network related values

ip_address

set the ip address fuppes should use.
If you leave the field empty or set it to 0 fuppes will try to detect the interface automatically.

  <ip_address>192.168.0.2</ip_address>

http_port

set the port fuppes' http server should bind on.
Empty or null uses random port (except when configured with option --enable-default-http-port)

  <http_port>5080</http_port>

allowed_ips

set ip addresses that are allowed to access fuppes.
if you set no addresses all adresses are allowed to access fuppes.
The address fuppes is listening on is allways allowed to access.

  <allowed_ips>
    <allowed_ip>192.168.0.3</allowed_ip>
  </allowed_ips>

content_directory

set content related values

local_charset

set the charset you are using.
this value is used to convert filenames from your local charset to UTF-8.
A list of valid charset names can be found at: http://www.gnu.org/software/libiconv/

  <local_charset>ISO-8859-15</local_charset>

max_file_name_length

the maximum length of filenames in the upnp directory listings.
some devices can't handle an unlimited length (e.g. the Telegent TG 100 crashes when receiving filenames containing more than 101 characters.
If you leave the field empty or set it to 0 the file name length is unlimited.

  <max_file_name_length>101</max_file_name_length>

playlist_representation

select how fuppes sends playlistcontent to upnp devices.
e.g. the Noxon 1 can't handle playlist files but containers.

  • file playlist are send a "real" playlist files (m3u or pls)
  • container playlist are send as playlist containers

  <playlist_representation>container</playlist_representation>

transcoding_settings

transcoding related options

audio_encoder

set the audio encoder you like to use.

  • lame use LAME
  • twolame use TwoLAME

transcode_vorbis, transcode_musepack, transcode_flac

select which audio format should be transcoded.

  <transcode_vorbis>true</transcode_vorbis>
  <transcode_musepack>false</transcode_musepack>
  <transcode_flac>true</transcode_flac>