

     ..|''||   '||'  '|' '||' '||    ||' '||'  '|' '||''|.
    .|'    ||   ||    |   ||   |||  |||   ||    |   ||   ||
    ||      ||  ||    |   ||   |'|..'||   ||    |   ||...|'
    '|.  '. '|  ||    |   ||   | '|' ||   ||    |   ||
      '|...'|.   '|..'   .||. .|. | .||.   '|..'   .||.


    FAQ
    Frequently Asked Questions

______________________________________________________________________________

q. Quimup?

a. [Q]t [U]ser [I]nterface for the [Mu]sic [P]layer Daemon (0.17.0 or above).
   A very Linuxian name indeed, and one you can Google for.
______________________________________________________________________________

q. MPD?

a. MPD is a daemon that runs in the background, plays your music and maintains
   a database of your music files. MPD does a great job, but can only be used
   with a client: it is as useless without the client as the client is without
   MPD. More information about MPD can be found at www.musicpd.org
______________________________________________________________________________

q. Will this QT program work with GNOME or XFCE?

a. Yes. Quimup does not depend on KDE in any way. It only needs some Qt libs.
______________________________________________________________________________

q. Where does the album art come from?

a. Quimup first queries MPD. If that fails it checks the directory where the
   audio file is located for a jpg, png, gif, bmp or svg file that matches
   C/cover*, A/albumart*, F/folder*, F/front* or * (in that order).
______________________________________________________________________________

q. Quimup can't find album art.

a. Make sure your mpd.conf file is set up correctly and that Quimup has access
   rights to mpd's music directory and its contents. To avoid mistakes set the
   MPDCONF parameter in /etc/default/mpd to e.g. /home/USER/.mpd/mpd.conf.
______________________________________________________________________________

q. Many features are disabled. What is the problem?

a. Possibly Quimup is not connected to MPD.

a. MPD does not allow the features to be used.
   The best solution is to run MPD as a user, not as a system service.
   This can be done with the command 'sudo systemctl disable mpd'.
   Next let Quimup start MPD (server tab in the settings window) with the
   command "systemctl --user start mpd" and close it, if you want, with
   "systemctl --user stop mpd".

a. Quimup does not have access to mpd's music directory and its contents.
   Possibly MPD and Quimup are not using the same mpd-configuration.
   To avoid mistakes set the MPDCONF parameter in /etc/default/mpd to
   /home/USER/.mpd/mpd.conf.
______________________________________________________________________________

q. How does 'Purge' work?

a. Purge removes all played items from the playlist. Note that the property
   is monitored by Quimup, not by MPD. If you close Quimup all the 'played'
   marks are lost.
______________________________________________________________________________

q. Why does connecting to MPD take so long?

a. Possibly MPD and Quimup are not using the same mpd-configuration. To avoid
   mistakes set the MPDCONF parameter in /etc/default/mpd - and make sure MPD
   and Quimup are both using the same connection (i.e the 'bind_to_address' in
   MPD's config and the 'host'in Quimup's connection profile.)

a. If MPD is started with quimup it may be busy updating the database before a
   connection is established. In MPD's configuration set auto_update to "no".
______________________________________________________________________________

q. Why does my remote connection fail when the server changes WiFi <> Wired ?

a. As a consequence you have also switched the server's IP address.
   You must set up a new connection to the other address.
______________________________________________________________________________

q. After starting a stream Quimup waits ... and reconnects to MPD?

a. A failing stream will time out after 10 seconds, If you have set the timeout
   of MPD to less Quimup assumes it is the connection that fails and reconnects.
______________________________________________________________________________

q. Why is copying files to the server where MPD runs so very slow?

a. The connection probably is not very fast (wifi) an MPD is polled frequently.
   Set te polling interval (settings > connect) to 1000 or more and reconnect.
   Ultimately you can temporarily disconnect from MPD.
______________________________________________________________________________

q. Why can't I open music files directly from the file manager?

a. MPD will accept external files only if quimup is connected to MPD through a
   "socket": both 'bind_to_address' in MPD's configuration file and 'host' in
   Quimup's login profile must point to /home/USER/.mpd/socket. Files can
   be dropped on the player or the playlist, or added  using 'open with' in
   your file manager (%U and %F are both accepted).
______________________________________________________________________________

q. Playing OGG files no kb/s is shown. Why?

a. You are using a decoder (vorbis) that does not provide that info.
   Add the following to your mpd.conf:
   decoder {
        plugin "vorbis"
        enabled "no"   }
______________________________________________________________________________

q. Wen I use 'open with quimup' the items are added in the wrong order. Why?

a. Your file manager uses 'quimup' or 'quimup %u' when it should use 'quimup %U'.
   You can change the command in the start menu or Quimup.desktop file.
______________________________________________________________________________

q. In the upper left corner of the window a 'W' is shown where the quimup
   icon should be.

a. You have moved from X to Wayland.
   Wayland reads the program's .desktop file to find out what icon to use.
   Quimup tells Wayland the exact name of this file: Quimup.desktop. If you
   use a different name Wayland can't find the icon and shows the generic 'W'.
______________________________________________________________________________

q. I don't like the names of the connection profiles. How can I change them?

a. "Autodetect" is hard-coded (as is what the profile does).
   The others get their names from ~/.config/quimup/quimup.conf
   Look for lines containing 'profile_name' and replace the name.
______________________________________________________________________________

q. Can I make a feauture request?

a. Of course you can. You can contact me at oubliette@xs4all.nl. But do keep
   in mind that Quimup is a no-bells-or-whistles music player: not a tag
   editor, iPod manager, sound converter or lyrics downloader.
______________________________________________________________________________



