Skip to main content

Using the scanner


Access the Scanner through Menu -> Preferences -> Scanner

Setting up the scanner is fairly straightforward.  You first want to add the location(s) of your music.  Press the Edit Scan Paths to bring up the popup in the image above.  By default /mnt/sdcard and /mnt/sdcard/Music will be added to the list of paths/folders.  To remove a path from the list, simply click the list item and press the remove button.  To add a new path you can either type it in manually in the edit box, or press the browse storage button to bring up a list of paths found on the device.  Once selected press the add button to add it to the list.  Click save to save all the changes.

Once the scan paths are setup, you can add specific paths to ignore the same way.  Press the 'Edit Ignore Paths' to tell the scanner what paths to skip over.

Scan Options

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

Popular posts from this blog

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

3.4.9

More fixes.  Check out discord for info on the 3.5 alpha. 3.4.9 (2024-02-14): Fixed tab navigation returning to the wrong view on screen orientation change Fixed queue not being focused on the playing track sometimes while using tab navigation 3.4.8 (2023-12-21): Fixed backup/restore intent receiver not working with IAP unlock Fixed crash sorting playlist contents

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