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
- Launch the app — you land on the Library screen with your audio collection front and center.
- Add music — import files from your device, connect a cloud source, or paste a web link.
- Tap any track to start playback. The Now Playing bar appears at the bottom.
- Explore the sidebar — navigate between Library, Playlists, Equalizer, Statistics, and Settings.
- Create a playlist from the Playlists tab to start organizing your favorites.
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.
Playlists
Build and manage playlists to organize your listening experience.
Creating a Playlist
- Navigate to the Playlists tab in the sidebar.
- Tap New Playlist and give it a name.
- Add tracks by browsing your library, or drag-and-drop from any source.
- 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
Equalizer
Shape your sound with a multi-band equalizer that offers both quick presets and full manual control.
Built-in Presets
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.
Cloud Sources
Connect your cloud storage accounts to browse and stream audio files without downloading them first.
Connecting a Cloud Source
- Open Cloud Sources from the sidebar.
- Select a provider and follow the authentication flow.
- Once connected, browse folders and add tracks to your library.
- 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.
Web Link Playback
Play audio from any direct URL without downloading the file to your device.
How to Use
- Tap the Add Web Link button in your library or use the + menu.
- Paste a URL pointing to an audio file (MP3, AAC, FLAC, OGG, WAV, etc.).
- The track is added to your library and streams directly from the URL.
Supported Formats
- MP3, AAC, M4A, FLAC, OGG, WAV, OPUS, and other common audio formats
- The URL must point directly to an audio file (not a web page containing embedded audio)
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.
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
| Shortcut | Action |
|---|---|
| Space | Play / Pause |
| → | Skip to next track |
| ← | Previous track / restart current |
| Shift + → | Seek forward 10 seconds |
| Shift + ← | Seek backward 10 seconds |
| ↑ | Volume up |
| ↓ | Volume down |
| M | Mute / Unmute |
| S | Toggle shuffle |
| R | Cycle repeat mode (off / all / one) |
| Ctrl + F | Search library |
| Ctrl + , | Open Settings |
| F1 | Open Help |
Tips & Tricks
Troubleshooting
| Issue | Solution |
|---|---|
| No sound during playback | Check 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 connect | Verify your internet connection. Try disconnecting and re-authenticating the cloud account from Cloud Sources settings. |
| Web link won’t play | Ensure 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 tracks | This 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 playback | Check that you set the correct duration. The timer only triggers when the countdown reaches zero. |
| Statistics seem incorrect | Play counts increment when a track plays past a minimum threshold. Skipping tracks quickly may not register a play. |
| Tracks missing from library | If 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.