UPGRADING

   1                        Music Player Daemon (MPD) - UPGRADING
   2
   3 Upgrading to 0.14
   4 -----------------
   5
   6 The filesystem character set is determined by GLib, if it is not
   7 configured.  GLib has an affinity towards UTF-8, while older MPD
   8 versions used to choose ISO-Latin-1.
   9
  10
  11 Upgrading to 0.13.0
  12 -------------------
  13
  14 JACK, Avahi, and libsamplerate have been added as optional dependencies.
  15 FLAC/OggFLAC now supports the 1.1.3 API, and libmikmod 3.2.0 betas are
  16 supported as well.
  17
  18 New mpd.conf parameters include zeroconf_name, samplerate_converter, and
  19 gapless_mp3_playback.  See the mpd.conf man page or updated mpconf.example for
  20 more information on these parameters.
  21
  22 Support for the ID3v2 "Original Artist/Performer" tag has been added.  Your
  23 MP3s will need to be rescanned for these tags to be included in the database.
  24 This can be done by running mpd --create-db.
  25
  26 Upgrading to 0.12.0
  27 -------------------
  28
  29 The ao_driver and ao_driver_options config parameters have been removed and
  30 replaced with the audio_output config section.  You will have to update your
  31 config file to use this instead.  See the mpd.conf man page or the new
  32 mpdconf.example for details on specifying audio_output sections.
  33
  34 The db_file parameter is no longer optional.  If you did not specify it in your
  35 old config file then you will have to add it in order to run 0.12.0.
  36
  37 Support for OggFLAC and Musepack audio files has been added.  Additionally,
  38 scanning of MP3 files has been improved.  To make use of these updates it is
  39 highly recommended that you run mpd --create-db to recreate your entire
  40 database.
  41
  42 Upgrading to 0.11.0
  43 -------------------
  44
  45 The database format has changed a little bit, but in a backward compatible way.
  46 This means that if you upgrade to 0.11.0 from 0.10.x, you do not need to make
  47 any changes.  However, if you downgrade back to 0.10.x, then you will need
  48 to recreate your db.
  49
  50 The default port for MPD is now 6600, so update your mpd and client
  51 configurations appropriately.
  52
  53 Upgrading to 0.10.0
  54 -------------------
  55
  56 All information is now stored in the db in UTF-8 format, and the character
  57 set used for the filesystem is stored in the db.  Thus, it is highly
  58 recommended that you recreate the db.  To do so, run mpd with the
  59 "--create-db" command line option.  Also, note that the filesystem
  60 character set will be determined from your current locale settings.
  61 If your locale settings are not the same as those used for the filesystem,
  62 then use the config file parameter "filesystem_charset" to specify the
  63 correct character set (this maybe necessary if you create the db with root).
  64
  65 Upgrading to 0.9.3
  66 ------------------
  67
  68 Wave support was added, so to have your wave files added, update the db (mpc
  69 update).
  70
  71 Also, song lengths are now stored in the db.  To get this stuff
  72 added to the db, you will need to recreate the db from scratch.  To do this,
  73 run mpd with the "--create-db" commandline option.
  74
  75 Upgrading to 0.9.0
  76 ------------------
  77
  78 The "stop_on_error" config parameter was removed, so be sure to remove this
  79 parameter from your config file.
  80
  81 Upgrading to 0.8.x
  82 ------------------
  83
  84 If you have FLACs, then to have them added to your list of available music,
  85 just use "update".
  86
  87 Upgrading from 0.5.x to 0.6.x
  88 -----------------------------
  89 If you have not compiled MPD with "make ogg", then nothing is needed.
  90
  91 If you compiled with "make ogg", just use "update" (available via the phpMp
  92 interface) to add your OGGs to MPD's list of available music.