English | 日本語


Last update: November 22, 2020

If you are new to yaMPC, please go through the tutorial first.

Link to yaMPC Tutorial

For more detail:

Using yaMPC (Online Manual)

Setting Cover-art for yaMPC

Ask a question to:



If you have a problem, please inform us:

  1. Your distribution and version (e.g. Volumio 2.729, MoOde 6.5.1, MPD 0.20.20 on Ubuntu 18.04 LTS, etc.) 
  2. Your device and iOS/iPadOS version (e.g. iPhone 8, iOS 13.4)
  3. What happened? Reproducible procedure if possible.
  4. Screen copy of Settings(⚙) - Statistical info, or if you can login to your MPD server, output of "mpc stats".
  5. Whether there are yaMPC’s crash logs (ips files) in Settings-> Privacy-> Analytics on your iPhone or iPad.


Enhancement requests are welcome as well.


Thank you for your cooperation in improving the quality of yaMPC!


We also have a Facebook page for user community.

Known Issues:

  • yaMPC may crash when it fails to create an HTTP session for downloading cover-art. (fixed in yaMPC 1.5.8)
  • yaMPC crashes if MPD Queue has files with "._" prefix (fixed in yaMPC 1.5.7).
  • yaMPC 1.5.2. Performance regression of getting MPD Queue. (fixed in yaMPC 1.5.4)

Technical faq

Q1: How can I display album cover-arts?

Q2: Refer to the "Cover-art" page


Q2: How to change sort order of albums in the Albums scenes?

A2: Queue → Settings (Cogs icon)  → Albums Sort Order, tap Title or Artist

If the album does not have Album Artist tag, then yaMPC uses Artist tag of the first song in the album for sorting.
yaMPC ignores "The" in artist names for sorting. (e.g. "The Beatles" is sorted as "Beatles")

Artis sort order is supported only if Fast Open Mode is OFF.

Q3: I cannot control Volumio with yaMPC

A3: Check the following two points.

  1. Volumio's Queue is not compatible with MPD's queue. Therefore, you cannot use Volumio Web UI and yaMPC simultaneously. Make sure to clear Volumio's Queue (click trash icon at upper right in the Volumio Queue screen) before launching yaMPC. yaMPC may cause error if you use Volumio Web UI simultaneously.
  2. Set "MPD Clients Volume Control" ON at Volumio's Volume Options if you want to control volume from yaMPC.

Q4: I added songs to MPD but yaMPC does not display albums for them.

A4: When you add songs to MPD, follow the following steps.

  1. Settings(⚙) - Update MPD database
    (You can check database updated time by Settings(⚙) - Statistical info)
  2. At Players scene, tap the connected cell to re-connect.
    (or you can relaunch yaMPC to reconnect to MPD)
  3. If you added cover-art files, Settings(⚙) - Update thumbnail cache
    (You do not need step 3 if Fast Open Mode is ON)

Q5: I have replaced a cover-art file then tapped Update thumbnail cache. But yaMPC still displays the old cover-art.

A5: When you replaced cover-art files,

  1. Settings(⚙) - Clear thumbnail cache 
  2. Settings(⚙) - Update thumbnail cache
    (You do not need step 3 if Fast Open Mode is ON)

Q6: I installed MPD on Ubuntu (or Raspberry Pi OS). But the Scan button of yaMPC Players Settings does not identify my MPD.

A6: If you installed MPD using apt or apt-get, systemd socket activation would be automatically configured. However, that disables zeroconf settings of MPD. To enable zeroconf so that the Scan button can detect your MPD, disable mpd.socket as follows:

$ sudo systemctl stop mpd.service

$ sudo systemctl stop mpd.socket

$ sudo systemctl disable mpd.socket


$ sudo systemctl start mpd.service

Also, make sure the lister settings and zeroconf settings in the mpd.conf file.


bind_to_address   ""

zeroconf_enabled   "yes"

change log

What's New in yaMPC 1.6.1 (January 1, 2021)

  • Supports Consume mode (Settings -> MPD Server -> Consume mode)
  • Fixed a crash bug when deleting a playlist.


What's New in yaMPC 1.6: (November 22, 2020)

  • Supports iOS/iPadOS 14
  • Downloads cover-arts directly from MPD without using HTTP. MPD 0.21 or later is required. Filename for cover-art must be 'cover.jpg'. (Player Settings -> MPD/URL -> MPD 0.21 or later)
  • The default cover art slowly blinks during playback
  • Long-pressing an album in the Albums view to show the play menu
  • Play a song and automatically return to the home view of your choice - Playing or Albums. (Settings -> Options -> Auto-return, iPad only)

What's New in yaMPC 1.5.9: (August 6, 2020)

  • Displays a checkmark at the currently connecting MPD player in the Players scene.
  • Supports displaying sample rate for DSD in the Playing scene. For example, "2.8MHz / DSD" for DSD64 music file.

What's New in yaMPC 1.5.8: (July 6, 2020)

  • Fixes a crash bug when yaMPC could not connect to HTTP server.
  • The default cover-art, used when an album does not have its cover-art image, now supports Dark mode.

What's New in yaMPC 1.5.7:  (June 15, 2020)

  • Fixes a crash bug when files with "._" prefix are in the Queue

What's New in yaMPC 1.5.2 (May 6, 2020)

  • We have redesigned the UI from the ground up: a simple and clean appearance, bigger and more beautiful cover arts, and easier to navigate.
  • Supports menu buttons ("..." icon) in addition to a long press to display a pop-up menu.
  • Supports enabling or disabling each output of MPD (audio_output settings in mpd.conf)
    Queue -> Settings (cogs icon) -> Outputs
  • Supports adding all songs under a folder (In App Purchase required)
    Browse -> Folder -> menu button ("..." icon) in the folder list
  • Fixes several crash bugs reported by users and Beta testers.

Bug Fixes by yaMPC 1.3.4: (January 2, 2020)

  • If you place your iPad flat, Queue view become narrower when yaMPC is launched (or recovered from background).
  • In Fast Open Mode, "Connection lost" message is displayed when yaMPC is recovered form background.

yaMPC 1.3.3: (December 5, 2019)

  • Supports iOS/iPadOS 13.2.x
  • Fixes memory leak in Fast Open Mode.

 What's New in yaMPC 1.3.1: (November 13, 2019)

  • "Test HTTP Connection" button provides more information when HTTP failed.
  • Added a switch to turn iPad master-detail view ON or OFF. (Queue -> Settings (cogs icon) -> iPad master-detail UI)

 Bug Fixes by yaMPC 1.3.1:

  • yaMPC crashes by displaying Queue before connecting to MPD.
  • yaMPC ignores music files which file name contain "._".

 What's New in yaMPC 1.3: (October 21, 2019)

  • iPad optimized UI (Master-Detail Interface)
  • iPad multitasking - Split View and Slide Over
  • Dark Mode in iOS 13

What's New in yaMPC 1.2.1: (August 6, 2019)

  • Fast Open Mode (You can turn this mode ON or OFF in Connection Settings scene)
    • ON: Differ loading album data until a song or an album is actually displayed. Best mode if you have thousands of albums.
    • OFF: Load all albums data when yaMPC connects to MPD. Scroll speed at Albums scene is faster. Best mode if you have a few hundred or less albums.
  • Always displays the currently playing song in Queue scene.
  • Long pressing an item of Genre, Artist or Composer list in Browse scene adds all matched songs to Queue. (In-App Purchase required)

Bug Fixes by yaMPC 1.2.1:

  • Fixed some crash bugs reported from users. Improved stability.
  • Next button plays the next song in Queue even in random play mode. Now next button plays a song randomly.

What's New in yaMPC 1.1.1: (May 26, 2019)

  • Improved Browse scene (a feature In App Purchase is required)
    • Settings scene: Browse Method - Simple (Fast) or Complete (Accurate) options are obsolete. Now always Fast and Accurate.
    • Settings scene: Artist Browse Mode - Album Artist or Artist options are supported.
  • Albums scene
    • When album sort order is Artist, use the following tag values for sorting if either of them is defined.

What's New in yaMPC 1.1: (April 15, 2019)

  • Connection Settings scene: Scan button auto-detects your MPD (Thanks to Bonjour!)
  • Settings scene: Albums scene sort order - by Title or Artist
  • Settings scene: Display statistical information (e.g. last db update)
  • Play scene: Info button displays song details
  • Volume scene: +/- buttons for minor volume adjustment
  • Settings scene: Support of 4 and 5 cover-arts in row for iPad

Bug Fixes by yaMPC 1.1:

  • Downloading a cover-art fails if its folder name includes Unicode combining characters (e.g. German Umlaut "ä ö ü")
  • Tapping Next button at the last song of the Queue generates "MPD Error Bad song index" error.
  • Tapping Prev button crashes yaMPC if the queue is empty.
  • If a playlist does not include any song (e.g. you removed the USB memory), “Bad song index” error is displayed.