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
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.
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:
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
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
- Default: Nothing is changed and the screen will shut off normally
- Dimmed: The display will not fully shut off, but will stay in a dimmed mode
- Screen Bright: The display will stay fully lit
- Full Bright: The display and keyboard will stay fully lit
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.
- Off: Turns off auto volume adjust
- Use Defaults: Changes the volume to the defaults set in the preferences
- Restore Last Used: Restores the volume to the last used volume for that particular output
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:
- Stop: Stops playback
- Play Random: Picks a song at random and plays it
- Loop Playlist: Restarts the current playlist
- Play Random Album: Plays an album at random and plays it
- Play Rest Of Album: Plays the remainder of the album the last track in the playlist is from
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