UPGRADING

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