Quick Start

This guide will quickly, in 8 steps, show how to get started once you installed GMPC. This guide assumes that you allready setup MPD and it is working.

  1. Step 1

    Start GMPC. Normally GMPC can be found in the menu under: Applications->Multimedia->Gnome Music Player Client This should be identical under GNOME, KDE, Unitiy and XFCE. If you start it from a terminal, or using a run dialog (alt-F2) type gmpc

  2. Step 2

    The first time you run gmpc, you see a first-run wizard. Follow the wizard step by step.

    If you do not get the wizard. You can get the same connection pane, by going to the preferences. Music->Preferences.

  3. Step 3

    Enter the ip of the machine running mpd. If GMPC and MPD are running on the same machine, you can enter localhost in the Host field. If MPD is running on a different machine, enter the external IP address of that machine. In the screenshot this is 192.150.0.102

    If you password protected your MPD, enable Use Authentication and enter the password below.

    Press Connect, if that succeeds, we can continue to the final page of the wizard.

    If GMPC fails to connect to MPD, check if MPD is running. If MPD is running on a different machine, check if MPD accepts connections from the network. This is configured with the bind_to_address option in mpd.conf.

  4. Step 4

    If GMPC is successfully connected we can close the wizard.

  5. Step 5

    If you already add music to the play queue from another client you will see this play queue in GMPC. Clients are kept into sync with each other.

    (update screenshots)

    When running GMPC for the first time we see the now playing screen. This does not display anything because no music is currently playing.

    Lets add some music, the easiest way is using the file browser (called Database). You can find the database in the left pane.

  6. Step 6

    If you see no folders or music in the Database, it means MPD has not indexed your music. To let MPD index your music go the the Server menu and press Update MPD Database. In the lower right corner a updating icon will appear. If after updating the database view is still empty you might want to check the MPD documentation on how to solve this.

  7. Step 7

    To add a songs you right-click on the folder and press add.

  8. Step 8

    Now the play queue is filled, lets select a song an play it. (double click on the song).