- Installation
- Configuration
- basic
- device settings
- virtual container layout
This document is outdated. Please take a look at the wiki for an up-to-date description.
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>