Skip to main content

Preferences Explained

There are many options in GMMP that might be confusing since there is limited room in the app itself to give a good explanation.  Here is a detailed explanation of every preference available.

Updated: 1/2/11

Scanner 
Edit Scan Paths:  Create a list of paths where all your music is stored.  If your specific path is not found when clicking 'Browse Storage', simply enter the path in manually into the edit box and click add.

Edit Ignore Paths: List folders you specifically want the scanner to ignore.  Anything in this directory will not show up in any of the library views.

Delete database before scan:  Wipes the entire database before running a scan.  This option is not typically needed but is present in case the user wants to start fresh without having to uninstall then reinstall.

Only scan new files:  If this is enabled, any file that was already scanned into the database will be automatically skipped over.  If you are using an external tagger to retag your music, disable this option to pick up all the changes.

Ignore folders with .nomedia:  This is a behavior that the default android music player follows.  Any folder with a file named .nomedia, will get skipped over.  This is useful if you have folders with ringtones or other sound bytes that you do not want showing up into GMMP.  Note: the ignore paths can also be used to skip these paths.

Format artist/album tags:  Artist names and album names will be formatted into proper case before being entered into the database.  This is useful if your music collection is not tagged to any standard.  Example:  I have 3 albums by "insert band name here".  The first album the artist is tagged "Insert Band Name Here", 2nd album "INSERT BAND NAME HERE", and 3rd album "insert band name here".  With this option off, each album would be recognized as being from a separate artist.  With this option on, all 3 albums are inserted into the database as the same artist "Insert Band Name Here".  If you have taken the time to properly tag all your music, you will not need to worry about this option.

Ignore AlbumArtist tag:  By default the scanner will use the albumartist tag if it exists instead of the artist tag to label albums.  Enable this if you want to ignore that tag

Scanner Menu Options (Press the menu button in the scanner)
Clean Database:  Removes any missing songs, artists, albums, or genres from the database.  This is typically done at the end of a scan, but it can be done independently as through this option.

Setup Auto Scan:  This sets the scanner to run at the given interval

Database Stats:  Shows the number of songs, artists, album artists, albums, and genres scanned into the database

General
Enable Lockscreen Player:  When enabled, a view similar to now playing will show up overtop of your devices lockscreen, allowing full control of playback without unlocking the device.

Device Preferences 
Display Wake Mode:  Technical details can be found here
  1. Default:  Nothing is changed and the screen will shut off normally
  2. Dimmed: The display will not fully shut off, but will stay in a dimmed mode
  3. Screen Bright:  The display will stay fully lit
  4. Full Bright: The display and keyboard will stay fully lit
Always Keep Device Awake:  Prevents the device from falling into a deep sleep.  This option should only be needed on non phone android devices.


Headset Preferences 
Auto Play/Pause:  This will pause playback if the headset is removed while audio is playing.  If playback was paused automatically, plugging the headset back in will resume playback.  However if the user manually pauses playback before unplugging, plugging back in will not resume.

Auto Resume When Plugged:  Always resume playback when plugging in a headset

Prevent Sleep:  On devices that can go into a deep sleep / hibernate state, this option will prevent that from happening for the amount of time specified.

Enable Headset/Remote Controls:  This will allow GMMP to respond to any media intent sent by bluetooth/headset remote controls, or other apps that control playback.

High Priority Receiver:  When enabled, GMMP should be the first app to receive any of the media intents.  Disable this if you want GMMP to still respond to the commands, but allow other apps to intercept them first.

Multi-Press Enabled:  For headset controls that only have one button, this option will make it so a single press of that button will play/pause, double press will go to the next track, and triple press will go to the previous track.

Call Handling 
Resume On Call End:  When a phone call is being received, GMMP will automatically pause playback.  Turn this option on if you want playback to resume after the call ends.

Button Override When Screen On 
Volume:  This feature does not work very well, but if enabled and GMMP is in focus, and the screen is on, the volume buttons will let you change tracks.

Scrobbler Preferences
Scrobble Droid:  Scrobble plays through scrobble droid

Simple LastFM:  Scrobble plays through simple lastfm

Album Art Preferences
Auto Download Album Art:  Will search for album art if not present.  The search is not 100% accurate for artists with common names.  If the wrong image downloads, you can manually change it.

Save In Lossless Format:  If enabled the images will be downloaded and stored as PNG instead of JPG

Album Art Download Location:  If there is a specific path you would like to download album art to, set that here.  Album art is downloaded to /sdcard/gmmp/albumart/ by default

Notifications
Show When Paused:  Enable if you want the notification icon to show when playback is paused


Error Reporting
Allow Crash Reporting:  Allows a crash report to be sent to the developer.  This is essential for making GMMP as stable as possible

Always Accept:  By default, the user is prompted with a popup asking if they want to send a crash report.  Enable this to automatically send it when an issue occurs.

Include System Logs:  Adds the system logs to the error report.  The logs contain extra information to help fix bugs.

Include Device Id:  Include the device id in the crash report

Error Log
Submit Report:  Sometimes errors can occur that are handled correctly by GMMP.  They get placed into the error log.  This allows the user to send a report to the developer without waiting for a crash.

Clear:  Clears the list of errors

Miscellaneous
Music Service Timeout:  Enable this if you want the music service to eventually shut itself down.  By default the service will stay running until the user exited GMMP.  Note:  Some features like auto play/pause will not work if the music service is not running.

Traditional Back Button:  Changes the back button behavior to be more like standard apps. Pressing back will return to the previous view instead of going to now playing

Tasker Integration:  Sends information about the currently playing back to Tasker.  Populates the following variables: %MTRACK %MARTIST %MALBUM %MTRACKNO

Audio
Show Compatibility:  Since not every android device is the same, this will show the support for each format on the device.  

Equalizer
Use GMMP EQ:  Use the high powered equalizer that comes with GMMP.  Disable on devices running 2.3+ in order to use the default android EQ.  The GMMP EQ is much higher quality and more customizable, but will use more CPU power compared to the android EQ.

Number of Bands:  If using the GMMP EQ, the number of bands can be set from 2 to 10.  The higher the band count, the more CPU power will be used.  Note: If too much CPU power is used, playback could begin to stutter.

Quality:  Choose between 3 different equalizer algorithms to process the audio.  The default quality is already really good, but higher quality settings are available at the cost of higher CPU usage.  Note: If too much CPU power is used, playback could begin to stutter.

Crossfade
Enable Crossfade:  Turns on the crossfader

Auto Track Change:  Enables crossfading to occur when a song naturally transitions to the next

On Shuffle Only:  Only will crossfade on an automatic transition if shuffle is turned on.

Disable When Gapless:  Will not crossfade if there is a gapless transition between 2 tracks

Auto Crossfade Duration:  The length of the automatic crossfade

Manual Track Change:  Enables crossfading when the user manually changes tracks

Manual Crossfade Duration:  The length of the manual crossfade

Auto Volume Adjust
Volume Adjust Mode:  Automatically adjust volume when switching between bluetooth, headset, and the speaker.
  1. Off: Turns off auto volume adjust
  2. Use Defaults: Changes the volume to the defaults set in the preferences
  3. Restore Last Used:  Restores the volume to the last used volume for that particular output
Default Speaker Volume:  Volume to use if 'Use Defaults' is enabled when switching to the speaker

Default Wired Headset Volume:  Volume to use if 'Use Defaults' is enabled when switching to the wired headset

Default Bluetooth Volume:  Volume to use if 'Use Defaults' is enabled when switching to bluetooth

Playback
Enable Gapless Playback:  Enable gapless playback

Playback Buffer Size:  Set how much memory is used for playback.  Increase this value if doing other actions on the device while listening to music causes skips.

Playback Priority:  The priority of the playback thread.  It is safe to keep this high since not too much work is done here.

Decoding Priority:  The priority of the audio decoding.  Setting the priority low for this might cause skipping if GMMP is in the background, but setting it too high may allow GMMP to consume the CPU causing things to lock up.  It varies from device to device.  Leave this setting alone unless you are experiencing issues.


Preload Next Track:  Set how many seconds before the end of the currently playing back to load the next track in the playlist.  Note:  This must be set to greater than 0 in order to achieve gapless playback.  Also if crossfading is enabled, this value is typically ignored.

Seek Time:  Set how many seconds to skip when pressing the seek buttons

UI
Navigation Bar
Portrait Position:  The position of the navigation bar when the device is in portrait mode.  Options are top, bottom, left, and right.

Landscape Position:  The position of the navigation bar when the device is in landscape mode.  Options are top, bottom, left, and right.

Used Colored Icons:  Color the icons on the navigation bar.  Otherwise they will be grey/silver

Enabled Views:  Choose which views to enable on the navigation bar.  Not every view can be turned off, only the following:  Artist, Album, Genre, Song, Browser, and Equalizer

Other
Enable Transitions:  Enables the transitions that occur when switching views

Library
Artist Library
Show Artist Stats:  Displays track and album count when listing the artists.  Note: Enabling this might cause the artist list to take a little longer to load

Sort Options:  Choose the sorting order of the artist list. 


Ignore Prefix When Sorting:  Ignores the 'the' prefix when sorting by artist name

Album Library
Show Album Stats:  Displays the track count, album length, and year in the album listing. Note: Enabling this might cause the album list to take a little longer to load

All Album's Sort Order:  The sort order to use when viewing every album on the device


Artist Album Sort Order:  The sort order to use when viewing albums from a specific artist

Genre Library
Show Genre Stats:  Display the track and album count when listing the genres.  Note: Enabling this might cause the genre list to take a little longer to load

Sort Options:  Choose the sorting order of the genre list

Song Library
Show Track Stats:  Display the artist and album when viewing the list of all tracks on the device

Show Album Info:  Shows the album info and album art along with the song list when selecting an album

All Songs Sort Order:  The sort order to use when viewing every song on the device

Album Song Sort Order:  The sort order to use when viewing the song list for a particular album

File Browser
Sort Options:  Choose the sorting order of the file browser

Read Tags:  Will read and display tags for the audio file instead of just displaying the filename.  This will make navigation slightly slower since it has to open each file.

Delete Without Confirmation:  Disables the popup warning when deleting a file or folder

Song Actions
On Select (Stopped):  Default action when a song is selected when playback is paused or stopped.  Options are: Play, Play Next, and Enqueue


On Select (Playing)Default action when a song is selected when a song is playing.  Options are: Play, Play Next, and Enqueue

Queue Album On Song Play Action:  When selecting a single song to play, this will queue up the rest of the album along with it.

Other
Enable Quick Return:  If a view is already active, and that view's button is pressed in the navigation bar, it will cause the view to return to its original display.  This works for the artist, album, genre, song, and file browser views.  IE:  The user clicks down a few folders deep in the file browser, pressing the browser button again will return it to the root directory.

Now Playing
Get Metadata From Library:  Retrieves metadata about the current playing song from the database instead of reading the tags of the file.

Show Album Art:  Show album art for the current playing song

Show Seek Buttons:  Replaces the repeat and shuffle buttons with seek forward and backwards buttons

Background:  Choose the background to show behind the album art.  Default will show the gradient that fits the rest of the theme.  Black will show a black background.  Note: This option is here mainly for older devices that do not show gradients very well.

Display Metadata Icons:  Replaces the text for album/artist/trackname/genre with icons.

Font Size:  Set the font size for the now playing view

Album Art Scale Type:  Choose how the album art is scaled.  Fit center is the default, but the album art can be positioned differently and stretched to fit the screen depending on the setting.

Displayed Tags:  Choose which tags get displayed on the now playing view.  It is currently limited to Artist, Album, Track, and Genre.  This will be expanded in the future.

Skip Folder On Long Press:  If enabled, a long press of the next/previous track buttons will skip to the next folder.

Gesture
Enable Gestures:  Turns on gesture recognition for the now playing view

Customize Gestures:  Assign an action to each available gesture.

Playlist
On Playlist Completion:  Set what GMMP will do when the current playlist.  Options are:
  1. Stop:  Stops playback
  2. Play Random:  Picks a song at random and plays it
  3. Loop Playlist:  Restarts the current playlist
  4. Play Random Album:  Plays an album at random and plays it
  5. Play Rest Of Album:  Plays the remainder of the album the last track in the playlist is from
Playlist Storage Path:  Path to save playlists too

Wrap Trackname:  Wrap the trackname to a second line if it is too long to fit on a single line.

Shuffle
Shuffle Mode:  Set the current shuffle mode.  Options are: Shuffle Off, Shuffle Playlist, and Shuffle Collection

No Repeats:  A track will not repeat until every song in the playlist is played once.  This only works for Shuffle Playlist.

Search
Instant Search:  If enabled, searching will begin once the user starts typing.  This can be slow on very large collections.

Result Limit:  Limit the amount of results returned by the instant search. 

Search Categories:  Choose the categories to search.  Options are: All, Artist, Album, Song

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