Merge branch 'org.openembedded.dev' of git@git.openembedded.net:openembedded into...
[vuplus_openembedded] / packages / musicpd / mpd / mpd.conf
1 # An example configuration file for MPD
2 # See the mpd.conf man page for a more detailed description of each parameter.
3
4 # Required files and directories ##############################################
5 #
6 # This setting controls the top directory which MPD will search to discover the
7 # available audio files and add them to the daemon's online database.
8 #
9 #music_directory                        "~/music"
10 music_directory                 "/media/content"
11 #
12 # This setting sets the MPD internal playlist directory. The purpose of this
13 # directory is storage for playlists created by MPD. The server will use 
14 # playlist files not created by the server but only if they are in the MPD
15 # format.
16 #
17 #playlist_directory             "~/.mpd/playlists"
18 playlist_directory      "/var/lib/mpd/playlists"
19 #
20 # This setting sets the location of the MPD database. This file is used to
21 # load the database at server start up and store the database while the 
22 # server is not up.
23 #
24 #db_file                                "~/.mpd/database"
25 db_file                 "/var/lib/mpd/mpd.db"
26
27 # These settings are the locations for the daemon log files for the daemon.
28 # These logs are great for troubleshooting, depending on your log_level
29 # settings.
30 #
31 #log_file                       "~/.mpd/log"
32 #error_file                     "~/.mpd/error-log"
33 log_file                "/var/lib/mpd/mpd.log"
34 error_file              "/var/lib/mpd/mpd.error"
35 ###############################################################################
36
37
38 # Optional files ##############################################################
39 #
40 # This setting sets the location of the file which stores the process ID
41 # for use of mpd --kill and some init scripts. This setting is disabled by
42 # default.
43 #
44 #pid_file                       "~/.mpd/pid"
45 pid_file                "/var/lib/mpd/mpd.pid"
46 # This setting sets the location of the file which contains information about
47 # most variables to get MPD back into the same general shape it was in before
48 # it was brought down. This setting is disabled by default.
49 #
50 #state_file                     "~/.mpd/state"
51 state_file              "/var/lib/mpd/mpdstate"
52 #
53 ###############################################################################
54
55
56 # General music daemon options ################################################
57 #
58 # This setting specifies the user that MPD will run as, if set. MPD should
59 # never run as root and you may use this setting to make MPD change its user 
60 # id after initialization. Do not use this setting if you start MPD as an
61 # unprivileged user. This setting is disabled by default, and the server will
62 # run as root.
63 #
64 #user                           "nobody"
65 #
66 # This setting sets the address for the daemon to listen on. Careful attention
67 # should be paid if this is assigned to anything other then the default, any.
68 # This setting can deny access to control of the daemon.
69 #
70 # For network
71 bind_to_address         "any"
72 #bind_to_address                "127.0.0.1"
73 #
74 # And for Unix Socket
75 #bind_to_address                "~/.mpd/socket"
76 #
77 # This setting is the port that is desired for the daemon to get assigned to.
78 #
79 port                            "6600"
80 #
81 # This setting controls the type of information which is logged. Available 
82 # setting arguments are "default", "secure" or "verbose". The "verbose" setting
83 # argument is recommended for troubleshooting, though can quickly stretch
84 # available resources on limited hardware storage.
85 #
86 #log_level                      "default"
87 #
88 # If you have a problem with your MP3s ending abruptly it is recommended that 
89 # you set this argument to "no" to attempt to fix the problem. If this solves
90 # the problem, it is highly recommended to fix the MP3 files with vbrfix
91 # (available from <http://www.willwap.co.uk/Programs/vbrfix.php>), at which
92 # point gapless MP3 playback can be enabled.
93 #
94 #gapless_mp3_playback                   "yes"
95 #
96 # This setting enables MPD to create playlists in a format usable by other
97 # music players.
98 #
99 #save_absolute_paths_in_playlists       "no"
100 #
101 # This setting defines a list of tag types that will be extracted during the 
102 # audio file discovery process. Optionally, 'comment' can be added to this
103 # list.
104 #
105 #metadata_to_use        "artist,album,title,track,name,genre,date,composer,performer,disc"
106 #
107 ###############################################################################
108
109 # Symbolic link behavior ######################################################
110 #
111 # If this setting is set to "yes", MPD will discover audio files by following 
112 # symbolic links outside of the configured music_directory.
113 #
114 #follow_outside_symlinks        "yes"
115 #
116 # If this setting is set to "yes, MPD will discover audio files by following
117 # symbolic links inside of the configured music_directory.
118 #
119 #follow_inside_symlinks         "yes"
120 #
121 ###############################################################################
122
123 # Zeroconf / Avahi Service Discovery ##########################################
124 #
125 # If this setting is set to "yes", service information will be published with
126 # Zeroconf / Avahi.
127 #
128 #zeroconf_enabled               "yes"
129 #
130 # The argument to this setting will be the Zeroconf / Avahi unique name for
131 # this MPD server on the network.
132 #
133 #zeroconf_name                  "Music Player"
134 #
135 ###############################################################################
136
137
138 # Permissions #################################################################
139 #
140 # If this setting is set, MPD will require password authorization. The password
141 # can setting can be specified multiple times for different password profiles.
142 #
143 #password                        "password@read,add,control,admin"
144 #
145 # This setting specifies the permissions a user has who has not yet logged in. 
146 #
147 #default_permissions             "read,add,control,admin"
148 #
149 ###############################################################################
150
151
152 # Audio Output ################################################################
153 #
154 # MPD supports various audio output types, as well as playing through multiple 
155 # audio outputs at the same time, through multiple audio_output settings 
156 # blocks. Setting this block is optional, though the server will only attempt
157 # autodetection for one sound card.
158 #
159 # See <http://mpd.wikia.com/wiki/Configuration#Audio_Outputs> for examples of 
160 # other audio outputs.
161 #
162 # An example of an ALSA output:
163 #
164 #audio_output {
165 #       type                    "alsa"
166 #       name                    "My ALSA Device"
167 #       device                  "hw:0,0"        # optional
168 #       format                  "44100:16:2"    # optional
169 #}
170 #
171 # An example of an OSS output:
172 #
173 #audio_output {
174 #       type                    "oss"
175 #       name                    "My OSS Device"
176 #       device                  "/dev/dsp"      # optional
177 #       format                  "44100:16:2"    # optional
178 #}
179 #
180 # An example of a shout output (for streaming to Icecast):
181 #
182 #audio_output {
183 #       type                    "shout"
184 #       encoding                "ogg"                   # optional
185 #       name                    "My Shout Stream"
186 #       host                    "localhost"
187 #       port                    "8000"
188 #       mount                   "/mpd.ogg"
189 #       password                "hackme"
190 #       quality                 "5.0"
191 #       bitrate                 "128"
192 #       format                  "44100:16:1"
193 #       protocol                "icecast2"              # optional
194 #       user                    "source"                # optional
195 #       description             "My Stream Description" # optional
196 #       genre                   "jazz"                  # optional
197 #       public                  "no"                    # optional
198 #       timeout                 "2"                     # optional
199 #}
200 #
201 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
202 #
203 #audio_output {
204 #       type                    "pulse"
205 #       name                    "My Pulse Output"
206 #       server                  "remote_server"
207 #       sink                    "remote_server_sink"
208 #}
209 #
210 ## An example of a null output (for no audio output):
211 #
212 #audio_output {
213 #       type                    "null"
214 #       name                    "My Null Output"
215 #}
216 #
217 # This setting will change all decoded audio to be converted to the specified
218 # format before being passed to the audio outputs. By default, this setting is
219 # disabled.
220 #
221 #audio_output_format            "44100:16:2"
222 #
223 # If MPD has been compiled with libsamplerate support, this setting specifies 
224 # the sample rate converter to use.  Possible values can be found in the 
225 # mpd.conf man page or the libsamplerate documentation. By default, this is
226 # setting is disabled.
227 #
228 #samplerate_converter           "Fastest Sinc Interpolator"
229 #
230 ###############################################################################
231
232
233 # Volume control mixer ########################################################
234 #
235 # MPD has limited volume controls, to use them pick one below. If one is not
236 # specified it may be autodetected at startup, depending on the dependencies
237 # which were compiled into the server.
238 #
239 # An example for controlling an ALSA mixer:
240 #
241 mixer_type                      "alsa"
242 mixer_device                    "default"
243 mixer_control                   "PCM"
244 #
245 # An example for controlling an OSS mixer:
246 #
247 #mixer_type                     "oss"
248 #mixer_device                   "/dev/mixer"
249 #mixer_control                  "PCM"
250 #
251 # This example is a general volume control mixer, it is used to adjust the 
252 # volume of the audio sent to the audio output, and will work with all outputs.
253 #
254 #mixer_type                     "software"
255 #
256 ###############################################################################
257
258
259 # Normalization automatic volume adjustments ##################################
260 #
261 # This setting specifies the type of ReplayGain to use. This setting can have
262 # the argument "album" or "track". See <http://www.replaygain.org> for more
263 # details. By default this setting is disabled.
264 #
265 #replaygain                     "album"
266 #
267 # This setting sets the pre-amp used for files that have ReplayGain tags. By
268 # default this setting is disabled.
269 #
270 #replaygain_preamp              "0"
271 #
272 # This setting enables on-the-fly normalization volume adjustment. This will
273 # result in the volume of all playing audio to be adjusted so the output has 
274 # equal "loudness".
275 #
276 #volume_normalization           "no"
277 #
278 ###############################################################################
279
280
281 # MPD Internal Buffering ######################################################
282 #
283 # This setting adjusts the size of internal decoded audio buffering. Changing
284 # this may have undesired effects. Don't change this if you don't know what you
285 # are doing.
286 #
287 #audio_buffer_size              "2048"
288 #
289 # This setting controls the percentage of the buffer which is filled before 
290 # beginning to play. Increasing this reduces the chance of audio file skipping, 
291 # at the cost of increased time prior to audio playback.
292 #
293 #buffer_before_play             "10%"
294 #
295 ###############################################################################
296
297
298 # HTTP Streaming Proxy ########################################################
299 #
300 # This setting specifies the HTTP proxy to use for playing HTTP streams. By
301 # default, these settings will be disabled.
302 #
303 #http_proxy_host                "proxy.isp.com"
304 #http_proxy_port                "8080"
305 #http_proxy_user                "user"
306 #http_proxy_password            "password"
307 #
308 ###############################################################################
309
310
311 # Resource Limitations ########################################################
312 #
313 # These settings are various limitations to prevent MPD from using too many
314 # resources. Generally, these settings should be minimized to prevent security
315 # risks, depending on the operating resources.
316 #
317 #connection_timeout             "60"
318 #max_connections                "10"
319 #max_playlist_length            "16384"
320 #max_command_list_size          "2048"
321 #max_output_buffer_size         "8192"
322 #
323 ###############################################################################
324
325
326 # Character Encoding ##########################################################
327 #
328 # If file or directory names do not display correctly for your locale then you 
329 # may need to modify this setting. After modification of this setting mpd 
330 # --create-db must be run to change the database.
331 #
332 filesystem_charset              "UTF-8"
333 #
334 # This setting controls the encoding that ID3v1 tags should be converted from.
335 #
336 #id3v1_encoding                 "ISO-8859-1"
337 #
338 ###############################################################################