Monday, August 15, 2011

Guide: The Basics

Edit: This guide is fairly outdated, but some things still apply.  Check the forums for more updated information.
 
Setup:
When first starting gmmp, you will want to scan in all your music.  Read the scanning guide here.  Also be sure to check out all the preferences available here.

Layout:

Title Bar: At the very top there is a title bar which is always visible.  It will say the current view that is selected.  On the right side of the title bar, there is an arrow icon which will toggle visibility of the Navigation Bar which is right below the title bar.

Navigation Bar:  The navigation bar lets you easily switch between the majority of views in GMMP.  The navigation bar is scrollable and it's location can be configured for both portrait and landscape mode in the preferences (Preferences -> UI).  Most of the views can be hidden via the preferences as well (Preferences -> Enabled Views).


Views:
Now Playing:

This is considered the main screen.  Hitting the back arrow from any other view will return to Now Playing first before going back to the desktop.  If you want to change this behavior to a more traditional back button style where back goes to the previous screen, you can (Preferences -> General -> Traditional Back Button)

Metadata Area:  Below the navigation bar in the picture above is the metadata area.  Information about the currently playing track will be displayed here.  By default the artist, album, trackname, and genre will show, more tags will be available in the future.  You can customize which tags will show (Preferences -> Now Playing -> Displayed Tags).  The font size of the tags can be changed as well (Preferences -> Now Playing -> Font Size).  Small icons will also show up if shuffle or repeat is enabled (a blue shuffle icon indicates shuffle collection, a white shuffle icon indicates shuffle playlist).

Album Art Area:  Under the metadata area, the album art is displayed.  There is a separate guide that goes into more detail about album art.

Gesture Area:  The metadata and album art area make up the gesture area.  Gestures can be enabled and customized under Preferences -> Now Playing -> Gesture

Music Controls:  At the bottom of Now Playing there are music controls.   A button to toggle the 3 shuffle modes (Off, Shuffle Playlist, Shuffle Collection) and a button to toggle repeat mode is located here a long with buttons to play/pause and change tracks.  The shuffle and repeat button can be replace with seek buttons in the preferences (Preferences -> Now Playing -> Show Seek Buttons)

Menu Options
Shuffle:  Change between the 3 shuffle modes

Repeat: This only will show up if "Show Seek Buttons" is turned on.  Toggles repeat mode on/off

Jump to Time:  Jump instantly to a specific time in the currently playing track

Volume:  Adjust the volume with a seek bar.

Sleep:  Turns on a sleep timer to pause playback after a set amount of time

Playlist:

This view shows you the active playlist.  The current playing track will be a lighter font color and in italics.  Press and hold the an entry in the playlist to bring up the context menu.  You can then choose to play that track or remove it from the playlist.  Long pressing the playlist button will bring up the 'Manage Playlists' view which is explained below.

Adding songs to the active playlist:
Adding to the playlist is simple.  From the artist, album, song, genre, or browser view simply long press a list entry to bring up the context menu.

You will have 3 play options:
Play: Erases the active playlist and will play your selection
Play Next: Adds your selection after the current playing track
Enqueue: Adds your selection to the end of the active playlist

Menu Options
Edit Mode:
Enabling edit mode will add arrows next to each song in the playlist.  Pressing the arrow will allow you to drag and drop a track to change the order.  You can also drag a song to the right and release to remove from the playlist.  The selected track will begin to fade out to indicate it will be deleted


Manage Playlists:

This view will show every single playlist file (m3u/wpl/pls) scanned into the database.  Long press a playlist to play, play next, enqueue, save to(saves the active playlist to the selected file), or delete.

Save:  Saves the active playlist

Clear:  Clears the active playlist

Randomize:  Will randomize the order of every song in the active playlist.


Artist:

This will show a list of every artist scanned into the database.  Long press an artist to bring up a context menu to play, play next, enqueue, or open the tag editor for the artist.  Normal pressing an artist will bring up the list of albums specific to that artist.

Menu Options
Artists/AlbumArtists:  You can toggle between viewing all the artists and only the album artists through this option.

Sort: You can also sort the artists alphabetically A-Z or Z-A.

Refresh:  Requery the database to get the list of artists again.

Album:


This view is very similar to the artist view, but it will list every album independent of the artist.  Compilations will show up listed with an artist of "Various".  There are more sorting options for the album view.  You can sort by album name, artist name, and year.

Song:

Lists every single song independent of the album and artist.  If you have a large collection it is urged to not use this view since it can get quite slow.

Genre:

Starts off with a list of genres and lets you dig down to artists, then albums, and then finally songs.

Browser:


This view lets you view all the music you scanned in a folder structure.  It works like any typical file browser.  Folders are represented by a folder icon and playlists are represented by the playlist icon.  To move back to the parent folder you can either hit the back button or press the arrow at the top of the list.  Sorting options are: filename, size, filetype, date, track number, trackname, and artist name.  Long pressing a folder, playlist, or file will bring up a context menu with the option play, play next, enqueue, or delete.  Delete will permanently remove the file/folder from the device.  Folders will also have a 'Scan' option which will tell the scanner to scan that specific folder for new music.

Equalizer:


Here you can change the audio balance, preamp gain, and the gain of each band.  Full guide here
Note:  The equalizer must be enabled for anything to take effect.  Menu -> Toggle EQ to enable.

Search:

Finally we have the search view.  Pressing the physical search button on the device will jump straight to this view or there is a button on the navigation bar to access the search view.  Type the search into the edit box and press the magnifying glass button to do a full search.  Clicking the X icon will reset the search.  By default, quick search is enabled, which will begin to search as soon as text is typed into the edit box.  This can be disabled in the preferences (Preferences -> Search -> Instant Search).  Long pressing an artist, album, or song will bring up the standard context menu allowing you to play, play next, or enqueue the selection.  A normal press of an album or artist will jump straight to the artist or album view for the selection.

Menu Options
Categories:  Choose what to search in.  Options are: Artist, Album, Song, or All

Reset:  Resets the current search