Skip to main content

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

Popular posts from this blog

GMMP 1.3 Released! ReplayGain, cuesheet, bookmarking, 6 new skins, and much more.

After about a month and a half of hard work, 1.3 is finally available for download on google play and this blog.  I've gone with the pendulum screenshot for the main image for a long long time and with the new album art as a background feature I decided to pick a new song to use. Changelog: 1.3.0 (06/14/12): New Features: -Added ReplayGain support -Added single file cuesheet support (.cue files) -Added manual bookmark option to the now playing menu -Added auto bookmarking options (Preferences -> Audio -> Bookmarks) -Added option to remove a song from the active playlist after it is played (Prefs -> Playlist -> Remove After Played) -Added dsp limiter with customizable attack and release settings (reduces audio distortion and clipping) -Added EQ and Limiter toggle buttons to the equalizer view -Added 9 new EQ presets: Bass Max, Bass & Treble, Classical, Techno, Club, Reggae, Soft, Rap, and Metal -Notification controls added to 3.0+ -The current play

3.4.0

Plans for 3.4 changed a bit when google announced they will be hiding apps on newer versions of android if they dont target the newer sdks.  GMMP always tries to target one of the more recent versions of android, but the unlocker has no need for that since its essentially just a license key.  As of May 1st the unlocker will be hidden on newer versions of android to those who have not already purchased.  Because of this, the focus of 3.4 was to get in app purchases working to allow users to buy the full version after May 1st.  There is a new 'Purchase' section in the settings where the unlocker can now be purchased. One other change in 3.4 is the support for the Android 13+ media controls.  They changed around how to customize them, so that is reflected in a new 'Media Controls' section of the settings. The language can also be changed for just GMMP via the system settings The changelog itself is fairly small but I did a large update of all the libraries / dependencies t

3.4.5 Release / Preview of 3.5

3.4.5 was just uploaded to google play and should be rolling out over the next few days. Changelog: 3.4.5 (2023-08-29): Added Dutch translation Fixed crash editing rules in rule groups Disable IAP donation options if Full Version Unlock has not been purchased to prevent confusion Other changes since 3.4.0: Added Finnish translation and updated other translations Added donation options to the purchase settings area Fixed crash when trying to bookmark / unbookmark currently playing song Fixed Finnish not showing up in the language select Fixed other various crashes Fixed issue where rating or editing tags could potentially split the album Fixed some of the lists/grids not refreshing after changes 3.5 Preview I've been working on some new UI options planned for 3.5.  So far I've finished a new gradient background option for now playing.  There are 2 different styles (linear / radial) with 2 different color sources for each.  One source will take from the theme colors, the other st