Web Interface Configuration Options

This document will cover those in the Database as all options in the config file are well documented. You can find a current copy of the config file at svn.ampache.org/trunk/config/ampache.cfg.php.dist. As an admin you can change the permission level required to change any of the below preferences by modifying the Level under Server Config for the preference in question.

This section contains all of the preferences directly relating to the interface and how Ampache look or displays information to the user.

• Popular Threshold
  • This setting determines how many Top artists, Top Albums, Statistics, Recently Played Tracks are listed throughout the interface. Larger numbers can increase load times as more data has to be displayed on any one page. The Default is 10.
• Language
  • Ampache is translated into many different languages using GETTEXT, this is a list of all current translations. At any one moment some of the strings may be missing from any one of the translations. If you would like to fix a missing string or contribute a new language please read svn.ampache.org/trunk/locale/base/TRANSLATIONS

• Theme
  • This sets the them for the current user. Ampache reads the /themes directory for a listing of all current installed themes. For more information on creating a theme see the Forums

• Album Ellipse Threshold, Artist Ellipse Threshold & Title Ellipse Threshold
  • These define how many letters, numbers, etc are displayed before a ellipse (…) is appended to the name and it is truncated. The truncation prevents interface distortion due to very long names.

• Min Album Size
  • This defines the smallest album that will be viewable when Browsing by Album. This can effectively hide a large portion of your music so be careful. The default value is 0.

• Statistics Day Threshold
  • This defines how many days are used to build the statistical displays in Ampache. Because the counts can get meaningless over the long periods of time, as it becomes impossible for new albums to ever make it near the top of the list you can limit the number of previous days used. The default value is 7, or one week.

This section defines how Ampache streams your Music. Some options in here require additional configuration in the /config/amapche.cfg.php

• Transcode Bitrate
  • This defines the bitrate you would like Ampache to attempt to transcode at. The default is 32kbps.

• Type of Playback
  • This is one of the most important options. It appears on the menu as well as a drop down. This defines what Ampache is to do with the music that is to be streamed. The default is Stream, other options include Localplay, Democratic, Downsampling, Flash Player.

• Transcoding
  • This defines the transcoding behavior of Ampache.

• Playlist Type
  • This defines what type of Playlist is generated by Ampache on play. Different applications work better with different playlist types. The default is M3u. This option has no effect in XSPF Flash, Democratic and Localplay Playback types.

• Playlist Method
  • This defines the behavior of the Play and Add actions in Ampache.
  • Send on Add: The playlist is sent to the music player client each time a song/album/artist is added (not recommended for MPD)
  • Send and Clear on Add: Same as “Send on Add”, but the playlist is cleared after being sent to the client.
  • Clear on Send: The playlist is sent to the music player client only with the “Play” button (radio tower icon), and then cleared.

This sections contains preferences for different features that can be enabled, disabled within Ampache.

• Allow Downloads
  • If this is enabled then you can download individual songs by clicking on their download link. If you have allow zip downloads in the config file this Option will also enable the Full Album, Full Artist, Selected, Playlist downloads. Default is disabled.

• Allow Direct Links
  • This puts a raw 'stream' URL link on every song line. This can be used to effectivly enqueue songs by dragging the raw URL into your audio player. This is also disabled by default.

• Localplay Access Level
  • This defines what type of access you have to Localplay. Global tells Ampache to use the settings defined in Admin –> Config for this user and to ignore any locally set settings. Local tells Ampache to first check the local settings. If they do not exist then fall back on the global settings. Disabled prevents all access to Localplay, this is the default value.

This section is only visible to Administrators and pertains to non-user options that often affect Ampache's operation as a whole, but are not deemed to be a security risk and thus are allowed to be in the Interface.

• Website Title
  • This defines the Website Title for your Ampache site, the default is “Ampache :: Pour l'Amour de la Musique” (Ampache :: For the Love of Music).

• Lock Songs
  • When enabled this prevents any two users from listening to the exact same song at the exact same time. This is a quasi legalize feature meant to simulate a shared pile of CD's in an office. Default is off

• Forces Http play regardless of port
  • This tells Ampache to always send HTTP in its playlists regardless of what the client is providing. This is enabled by default because a vast majority of players can not play HTTPS streams.

• Non-Standard Http Port
  • If defined this tells ampache to overwrite the current port and always use this port when building the stream URLs. Default 80

• Allow Streaming, Allow Democratic Play, Allow Localplay Play
  • These options control which play types are currently allowed. Streaming is the only one enalbed by default as all other options require additional configuration on the part of the administrator.

This is a list of the current Localplay Modules and Plugins that you can enable and disable. These Plugins and Modules may add additional preferences to Ampache which are not defined here. Catalog Updates will not be performed if there are any non-official Plugins currently installed.