English | 日本語

Support

Last update: July 18, 2024

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:

contact.yampc@gmail.com

 

Bug fix by yaMPC 1.8.3 (July 12th, 2024)

  • Fixed a rare crash bug when rotating the iPad.

What's New in yaMPC 1.8 (June 6th, 2024)

  • Radio station logo: Displays the Internet radio station logo, if available, in Playing and Queue scenes. (In-App Purchase required to play playlists containing Internet radio station URLs.)
  • New iPad UI mode: In addition to the existing iPad UI modes, an "Album Cover View" mode has been added to always display the cover art in a larger size when the iPad is in landscape mode.
  • A few bugs were fixed.
  • yaMPC 1.8 supports iOS/iPadOS 15, 16 and 17. iOS/iPadOS 14 is no longer supported.

For more information, please visit our blog here.

 

If you have a problem, please inform us:

  1. Your distribution and version (e.g. Volumio 3.695, MoOde 9.0.1, MPD 0.23.5 on Ubuntu Desktop 24.04 LTS, etc.) 
  2. Your device and iOS/iPadOS version (e.g. iPhone 15, iOS 17.5.1)
  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.
https://www.facebook.com/yaMPCapp

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

https://www.openaudiolab.com/yampc/coverart/

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. The volume control function in Volumio is detached from MPD too. yaMPC cannot control volume of Volumio.

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 2 if the 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.

Example:

bind_to_address   "any"

zeroconf_enabled   "yes"

Change log

Bug fix by yaMPC 1.8.3 (July 12th, 2024)

  • Fixed a rare crash bug when rotating the iPad.

Bug fix by yaMPC 1.8.2 (July 4th, 2024)

  • Fixed a crash bug in Album Cover View UI mode on iPad models with 4:3 screen ratio (e.g. 9th generation or older iPad).

What's New in yaMPC 1.8 (June 6th, 2024)

  • Radio station logo: Displays the Internet radio station logo, if available, in Playing and Queue scenes. (In-App Purchase required to play playlists containing Internet radio station URLs.)
  • New iPad UI mode: In addition to the existing iPad UI modes, an "Album Cover View" mode has been added to always display the cover art in a larger size when the iPad is in landscape mode.
  • A few bugs were fixed.
  • yaMPC 1.8 supports iOS/iPadOS 15, 16 and 17. iOS/iPadOS 14 is no longer supported.
    Check this blog for details.

What's New in yaMPC 1.7.4 (December 11th, 2022)

  • yaMPC 1.7.4 adds new support for iOS/iPadOS 16. It will continue to support iOS/iPadOS 14 and 15, but will no longer support iOS 13. If you are using iOS 13, please continue to use the stable version, yaMPC 1.7.2. 

Bug fix by yaMPC 1.7.2 (August 27th, 2022)

  • Fixes a crash bug when returning from the background.

What's New in yaMPC 1.7.1 (May 31, 2022)

  • Player Settings: supports MPD password.
  • Verified yaMPC on Apple Silicon Mac.
  • Playing: New default cover art images for albums and Internet Radio songs.
  • Playing:  Save a cover art image retrieved from MusicBrainz to "Photos".
  • Settings -> Albums Sort Order: New  sort order - Last Modified (in addition to title and artist)
  • Settings -> Disconnect in Background: option to disconnect or not disconnect MPD when transitioning to background (default is not disconnect)
  • Re-connect button on the errro dialog in case of disconnection from MPD due to fatal error
    Chceck this blog for details.

What's New in yaMPC 1.6.8 (October 17, 2021)

  • yaMPC 1.6.8 adds new support for iOS/iPadOS 15. It will continue to support iOS/iPadOS 13 and 14, but will no longer support iOS 12.
  • If you are using iOS 12, please continue to use the stable version, yaMPC 1.6.6.

What's New in yaMPC 1.6.6 (July 28, 2021)

Fixes the following bugs.

  • The "connection lost" message is displayed many times when the MPD server is stopped.
  • Several crash cases reported by users.

What's New in yaMPC 1.6.5 (May 11, 2021)

At Playing screen, yaMPC will search for cover art in MusicBrainz in the following cases:

1. when playing Internet radio and the radio station returns the artist and song title being played

2. when the cover art cannot be retrieved when playing a music file in the "music directory" of MPD.

If yaMPC can find the cover art in MusicBrainz, it will be displayed on the Playing screen.

In the case of 2. above, the retrieved cover art can be saved in the local cache of yaMPC.

Check this blog for details.

 

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.
      • ALBUM_ARTIST_SORT
      • ARTIST_SORT

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.