Help

Table of contents

• Controls
  • Main screen
  • File explorer
  • Queue
  • Bookmarks
• Search
• Seek/restore track position
• Album art
• Granting volume button longpress permission
• Troubleshooting

Controls

Main screen

• Swipe from left = show queue
• Swipe from right = show bookmarks

File explorer

• Directory press = open directory
• Directory longpress = add all tracks from directory to queue (not including subdirs)
• Track press = add to queue
• Track longpress = add to queue and play
• Back = go to parent directory

Queue

• Inactive track press = play
• Active item press = control playback (play/pause)
• Swipe right on item = remove track from queue
• Press and drag four-line icon = reorder track

Bookmarks

• Press bookmark = navigate to bookmark location
• Swipe left on item = remove bookmarks
• Press and drag four-line icon = reorder bookmark
• Storage devices button opens available storage devices (e.g. internal storage, sd card, pendrive)
• Add current dir button adds currently opened directory to bookmarks list

Search

Search is context-aware and only searches the currently opened directory, including one level of subdirectories.

Seek/restore track position

Restore time is saved only for one track. It is saved when notification closes or on manual track switch. Time is not saved when track is 30 seconds or more from beginning or end.

Album art

Album art priority: embedded artwork (tags) > Folder.png > Folder.jpg > Folder.jpeg.

Granting volume button longpress permission

This feature is based on skipTrackLongPressVolume project. It only works for Oreo or later versions (API 27+).

For something that should be a default feature it's a lot of hassle to achieve. You need to grant a permission via adb:

adb shell pm grant sancho.gnarlymusicplayer android.permission.SET_VOLUME_KEY_LONG_PRESS_LISTENER

To revoke permission, do:

adb shell pm revoke sancho.gnarlymusicplayer android.permission.SET_VOLUME_KEY_LONG_PRESS_LISTENER

Replace package name with sancho.gnarlymusicplayer.debug for debug builds.

Troubleshooting

• If the playback sometimes stops when a track ends with screen off, and resumes when device is awoken, this might be fault of overly aggressive power management. App uses a wakelock, but it doesn't help much. Disabling "battery optimization" for this app might help (do this in device settings)