# Quick Start

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

# 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

# First run wizard

After launching GMPC for the first time, you will 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`.

# Enter connection information

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.

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`.

# Connect

If GMPC is successfully connected we can close the wizard.

# The main interface

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

When running GMPC for the first time we see the now playing screen. This will 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.

# Browsing Library

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.

# Adding Music

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

# Play Music

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