QuickPlayer - Guide

QuickPlayer brings your entire audio world together — local files, cloud storage, and web links — in a single, elegant player with playlists, an equalizer, mood tagging, statistics, and a sleep timer. This guide covers everything you need to get the most out of it.

Getting Started

  1. Launch the app — you land on the Library screen with your audio collection front and center.
  2. Add music — import files from your device, connect a cloud source, or paste a web link.
  3. Tap any track to start playback. The Now Playing bar appears at the bottom.
  4. Explore the sidebar — navigate between Library, Playlists, Equalizer, Statistics, and Settings.
  5. Create a playlist from the Playlists tab to start organizing your favorites.
On desktop, the app starts in a spacious window. Use the sidebar toggle to maximize your library view, or resize the window freely.
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Interface Overview

Sidebar

The collapsible sidebar provides quick navigation across the app:

  • Library — browse, search, and manage all your audio files
  • Playlists — create and manage playlists
  • Equalizer — adjust sound with presets or custom bands
  • Cloud Sources — manage connected cloud accounts
  • Statistics — view your listening history and trends
  • Settings / Help — at the bottom of the sidebar

Now Playing Bar

The persistent bar at the bottom shows:

  • Current track title and artist
  • Play / Pause / Skip controls
  • A seek bar for scrubbing through the track
  • Volume slider and shuffle / repeat toggles
  • Quick access to Equalizer and Sleep Timer

Now Playing Screen

Tap the Now Playing bar to expand it into a full screen with album art, track details, and playback controls.

| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Library Management

Your library is the central hub for all audio content, regardless of where files are stored.

Adding Music

  • Local files — import audio files from your device storage
  • Cloud sources — connect Google Drive, OneDrive, Dropbox, WebDAV, or SFTP to browse and add tracks
  • Web links — paste a URL pointing to an audio file to add it to your library

Browsing & Searching

  • Search by title, artist, album, or tag across your entire library
  • Sort by name, artist, date added, play count, or duration
  • Filter by mood tag, genre tag, source type, or playlist membership

Mood & Genre Tagging

Assign mood labels (Energetic, Chill, Melancholic, Uplifting, etc.) and genre tags to any track. Use these tags to filter your library or create smart groupings.

Long-press a track to quickly assign or change its mood and genre tags without leaving the library view.
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Playlists

Build and manage playlists to organize your listening experience.

Creating a Playlist

  1. Navigate to the Playlists tab in the sidebar.
  2. Tap New Playlist and give it a name.
  3. Add tracks by browsing your library, or drag-and-drop from any source.
  4. Reorder tracks within a playlist by dragging them up or down.

Managing Playlists

  • Rename — tap the playlist title to edit it
  • Reorder tracks — drag handles on the left side of each track
  • Remove tracks — swipe a track or use the context menu
  • Delete playlist — available from the playlist options menu
Deleting a playlist removes the playlist only, not the underlying audio files from your library.
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Equalizer

Shape your sound with a multi-band equalizer that offers both quick presets and full manual control.

Built-in Presets

Preset
Flat
Neutral response with no frequency adjustment. The default starting point.
Preset
Bass Boost
Enhanced low frequencies for bass-heavy genres like hip-hop and EDM.
Preset
Rock
Boosted lows and highs with a slight mid scoop for punchy guitar-driven tracks.
Preset
Pop
Bright, vocal-forward balance designed for contemporary pop music.
Preset
Jazz
Warm midrange emphasis with smooth highs for acoustic and jazz recordings.
Preset
Classical
Wide, natural response that preserves the dynamics of orchestral music.

Custom Profiles

  • Drag each frequency band up or down to shape the response curve.
  • Tap Save to store your custom profile with a name.
  • Switch between saved profiles and presets at any time.
  • Use Reset to return all bands to the Flat position.
The equalizer applies in real time. Adjust bands while music is playing to hear the effect immediately.
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Cloud Sources

Connect your cloud storage accounts to browse and stream audio files without downloading them first.

Cloud
Google Drive
Sign in with your Google account to browse and stream audio files from Drive.
Cloud
OneDrive
Connect your Microsoft account to access music stored in OneDrive.
Cloud
Dropbox
Link your Dropbox account and play files directly from cloud storage.
Cloud
WebDAV
Enter your WebDAV server URL and credentials for self-hosted music access.
Cloud
SFTP
Connect to remote servers over encrypted SFTP for secure audio streaming.

Connecting a Cloud Source

  1. Open Cloud Sources from the sidebar.
  2. Select a provider and follow the authentication flow.
  3. Once connected, browse folders and add tracks to your library.
  4. Tracks from cloud sources stream on demand and are cached locally for smooth playback.

Managing Connections

  • Disconnect a cloud source at any time from the Cloud Sources screen.
  • Re-authenticate if a session expires — the app prompts you automatically.
  • Credentials are stored securely on your device and never transmitted elsewhere.
Streaming from cloud sources requires an active internet connection. For offline listening, download tracks to local storage first.
| │ | ┆ | │ | ┆ | │ | ┆ | │ |
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Statistics

Track your listening habits with detailed, automatically collected statistics.

What Is Tracked

  • Play count — how many times each track has been played
  • Total listening time — cumulative hours and minutes across all tracks
  • Top tracks — your most played songs ranked by play count
  • Top genres — genre breakdown based on your listening history
  • Mood distribution — what moods you listen to most often
  • Listening trends — daily and weekly activity patterns

Viewing Statistics

Open the Statistics tab from the sidebar to see your dashboard with charts and summaries. Data updates in real time as you listen.

Statistics are stored entirely on your device. They are never uploaded or shared with any external service.
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Settings

Playback

  • Crossfade — enable smooth transitions between tracks with adjustable duration
  • Gapless Playback — seamless track transitions for live albums and continuous mixes
  • Replay Gain — normalize volume across tracks to avoid sudden jumps

Sleep Timer

  • Set a countdown (5, 10, 15, 30, 60 minutes, or custom) to auto-stop playback
  • Fade out — gradually reduce volume before stopping for a gentle wind-down
  • Finish current track — option to complete the playing track before stopping

Toolbar

Customize which quick-action buttons appear in the top toolbar. Add, remove, or reorder actions to match your workflow.

Accessibility

  • Large Touch Targets — increase button sizes for easier interaction
  • High Contrast Controls — bolder visual indicators
  • Reduced Motion — minimize animations throughout the app

Cloud Sources

  • Cache Size — set the maximum local cache for streamed cloud audio
  • Auto-reconnect — automatically reconnect to cloud sources on app launch
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Keyboard Shortcuts

ShortcutAction
SpacePlay / Pause
Skip to next track
Previous track / restart current
Shift + Seek forward 10 seconds
Shift + Seek backward 10 seconds
Volume up
Volume down
MMute / Unmute
SToggle shuffle
RCycle repeat mode (off / all / one)
Ctrl + FSearch library
Ctrl + ,Open Settings
F1Open Help
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Tips & Tricks

Use mood tags to create instant filtered views. Tap a mood in the sidebar to see only tracks matching that vibe — perfect for setting the right atmosphere.
Set the Sleep Timer with Fade out enabled for bedtime listening. The music gradually lowers in volume before stopping, so you drift off naturally.
Connect multiple cloud sources to build a unified library. Tracks from Google Drive, Dropbox, and local storage all appear together and can be mixed in the same playlist.
Check your Statistics regularly to discover listening patterns you might not notice. Your top genres and mood distribution can reveal new recommendations.
On desktop, use keyboard shortcuts for hands-free control while working. Space to pause, arrow keys to navigate — no need to switch windows.
Save multiple equalizer profiles for different scenarios: one for headphones, one for speakers, one for late-night listening with boosted bass.
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Troubleshooting

IssueSolution
No sound during playbackCheck your device volume and ensure the in-app volume slider is not at zero. Verify that the equalizer is not set to extreme settings that mute output.
Cloud source won’t connectVerify your internet connection. Try disconnecting and re-authenticating the cloud account from Cloud Sources settings.
Web link won’t playEnsure the URL points directly to an audio file, not a web page. Some servers may block streaming — try downloading the file instead.
Playback stutters on cloud tracksThis is usually caused by a slow network. Let the track buffer for a few seconds, or download it to local storage for uninterrupted playback.
Sleep timer didn’t stop playbackCheck that you set the correct duration. The timer only triggers when the countdown reaches zero.
Statistics seem incorrectPlay counts increment when a track plays past a minimum threshold. Skipping tracks quickly may not register a play.
Tracks missing from libraryIf using cloud sources, ensure you are still authenticated. Disconnected sources hide their tracks until reconnected.
| │ | ┆ | │ | ┆ | │ | ┆ | │ |

Privacy

  • QuickPlayer does not require an account or sign-in for core functionality.
  • No usage data, analytics, or telemetry is collected.
  • Cloud credentials are stored securely on your device and never shared.
  • Listening statistics are stored locally and never transmitted externally.
  • Mood and genre tags are stored on-device only.
  • Core playback works fully offline. Internet is only needed for cloud sources and web links.