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 ot...

3.4.17 and 3.5 Beta 1 Released

I was not planning on putting out any more 3.4.x updates, however google refused to approve the 3.5 beta due to some policy updates that caused the existing 3.4.x version already released to no longer be compliant.  Therefore 3.4.15-3.4.17 are basically the work I've been doing on 3.5 for the last 16 months, but with all the new features disabled.  I would like to put them through more testing before enabling to the public, hence the beta. 3.4.17 (2024-10-25): Fixed crash on android 14+ trying to verify the unlocker 3.4.16 (2024-10-24): Fixed multi select in album details highlighting the wrong item 3.4.15 (2024-10-23): Update target api level to 34 Updated dependencies Manual scans are no longer ran in a foreground service due to google's new policies Last played time added to song info pop up Fixed issue where extra space was added in artists with numbers in name Increased full search limit from 100 to 10000 results Fixed issue with files missing tags showing up in the unkno...

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