Help & Support

The complete Juicy Player user guide — every screen, every feature. Last updated October 2026.

Getting Started

Three steps and you're playing music:

  1. Install JuicyPlayer on your computer. Download the installer from the Juicy Player website — Windows x64, Windows ARM64, or the macOS DMG (Apple Silicon, macOS 15.0 or newer) — and drag the app into your Applications folder, if you're on a Mac.
  2. Point it at your music. On first launch a welcome window asks you to choose your music folders — pick where your library lives and JuicyPlayer scans it, reading tags, covers, and audio quality as it goes. You can add more folders anytime, or simply drag files and folders onto the app.
  3. Press play. That's it. Everything stays on your own machine — no account required, no telemetry, nothing leaves your computer unless you ask it to.
Tip: on first launch, Windows may ask for permission to let Juicy Player communicate on the network. Choose Allow on private networks — this is what lets your phone (and the optional web remote) find the player later.

The Main Window at a Glance

The app is a single dark window built around three areas:

Juicy Player main window showing the All Music overview page with library statistics and the playback bar
The main window. All Music overview with library stats (1,031 tracks, 174 albums), the currently playing track on the right, and the playback bar at the bottom showing a live LUFS badge.

Browsing Your Library

All Music is your library browser, organized into five tabs: Overview, Songs, Albums, Artists, and Genres.

All Music Songs tab showing a track list with duration, quality and size columns
The Songs tab. Every row shows duration, bitrate, sample rate and file size. Use Play all, Shuffle or Play Next from the toolbar, and right-click any track for the full action menu.

Right-click any track (or select several) to add to playlists or the queue, play next, search lyrics, save album art, copy the file path, edit properties, and more. The Properties dialog lets you edit tags directly — and can fill in missing tags automatically from MusicBrainz and Discogs, or fetch missing cover art from iTunes.

Every folder you import is also a browsable mini-library with its own subfolder navigation, sort order and in-view search. Missing covers are fetched automatically; embedded tags always take priority.

Playlists & Favorites

The Playlists page combines smart mixes with your own:

Playlists page showing smart playlists like Daily Mix, Rediscover and Quick Hits
Smart mixes and custom playlists live side by side. Right-click any card to rename, re-cover or delete it.

Favorites is one tap away: hit the heart in the playback bar, on any track row, or via the right-click menu. The Favorites page can export to M3U or plain text, and supports batch-adding whole albums or artists.

Favorites page with play all, shuffle, import and export buttons plus a track table
Favorites. Export your loved tracks as M3U or TXT, or import from another player.

Now Playing, Lyrics & Queue

The Now Playing page is the player's showpiece — cover art, transport controls, format badges (codec, bitrate, sample rate, LUFS), and a side panel with your queue, recommendations and recently played. It's also fully skinnable: switch skins in Settings → Appearance, browse the Skin Store, import skin packs, or even design your own with the AI Assistant (see below).

Now Playing page showing the cover card, playback controls and a 1021-track queue panel
Now Playing. The right-hand panel keeps your queue (all 1,021 tracks of it), recommendations and history one click away.

Lyrics

Switch to the Lyrics tab for synced, karaoke-style lyrics. If a track has no lyrics yet, hit the lyrics button in the playback bar — JuicyPlayer searches the lrclib.net online database and saves a matching .lrc file next to your music. Lyrics also appear in the Mini Player, in the macOS widget, and on the desktop wallpaper.

Found a track with a _novocals accompaniment file (see Demucs below)? The karaoke button in the visualization view swaps to the instrumental while keeping your place — instant karaoke night.

The Queue

Hit the Queue button in the playback bar to open your queue as a cinematic 3D cover-flow: click a neighbouring cover to bring it front and centre, click the centre cover to play it, or scroll and use the arrow keys. "Play Next" and "Add to Queue" from any track's right-click menu slot songs into it, and the queue survives restarts — close the app mid-playlist and pick up exactly where you left off.

Playback Queue cover flow showing album covers in a 3D carousel
The queue as a cover flow. Click a cover to play it; the dimmed overlay closes the view.
Playback modes cycle with the mode button: sequential → random → repeat one. The queue, volume and last track are all restored automatically on the next launch.

The Home Dashboard

Home is your personal dashboard: a clock and live weather, a greeting that follows the time of day, your listening stats for today (plays, streak, completion rate), one-tap quick actions (Daily Mix, Favorites, Radio, Shuffle, Surprise Me), and AI-generated picks tuned to the moment — Right For Now, Trending Now, Deep Cuts and Forgotten Gems, each with a one-line reason why it picked that track.

Home dashboard with clock, weather, listening stats, AI picks and quick actions
Home. Time-aware greetings, live weather, today's numbers and AI picks you can play or save as a playlist.

Internet Radio

The Radio page puts tens of thousands of live stations a click away:

Radio page showing the station directory with featured stations and trending picks
Radio. 60,000+ live stations, no account needed. HLS streams play natively through the player engine.

Listening History & Statistics

History tracks everything you've played, filterable to today, this week, or this month — with totals for plays, listening time and completion, recent-play cover rails, and an analytics block (top tracks, top artists, audio-quality mix, format breakdown).

History page with total plays, duration, analytics and recent plays
History. Filter by period, then dig into your own listening analytics.

Want the long version? The Home dashboard's Stats tab opens a full statistics page with hourly listening charts, era and mood breakdowns, and deep dives you can click through to the underlying artists and albums.

DSP & Audio Effects

This is where Juicy Player earns its keep. Two ways in:

The Professional DSP panel

Open it from the DSP Playground toolbar (Open DSP Panel) or the Audio Effects button in the sidebar for quick toggles. The panel chains 19 studio-grade effects you can reorder, enable individually, or bypass all at once with the Direct switch:

Professional DSP window showing the 12-band equalizer with AutoEQ headphone correction
The Professional DSP panel. A 12-band EQ with an FiiO FT1 Pro AutoEQ correction curve loaded, live frequency response, and the full effect chain in the left rail.

The DSP Playground

For the adventurous, DSP Playground is a full node-based patching environment wired into the live audio path: oscillators, filters, dynamics, crossovers, math and routing nodes — nearly a hundred of them — connected on an infinite canvas. Save patches as presets, and let the built-in AI assistant design a graph for you: describe the effect you want in plain language, review the generated graph, and apply it to the canvas.

DSP Playground showing the node library and a graph connecting Input to Linear Gain
DSP Playground. A node library with live search, multi-tab graphs, and an AI assistant that builds signal chains from a description.
Audio nerd details: per-device Exclusive Mode (WASAPI exclusive on Windows, CoreAudio hog mode with native integer output on macOS) delivers bit-perfect output, with an optional sample-rate limit up to 384 kHz. Balance Volume uses analysed LUFS loudness to level the playing field across tracks — click the LUFS badge in the playback bar for full loudness details.

Built-in Tools

The Tools button in the title bar opens a small toolbox of heavy-duty utilities:

AI Assistant & Recommendations

The AI Assistant (sidebar, bottom) is a full AI workspace built into the player:

The same configuration powers the AI recommendations on the Home dashboard and the "Recommended for you" tab in Now Playing. No API key? The built-in local recommendation engine still delivers Trending, Deep Cuts, Forgotten Gems and mood-based picks — computed entirely on your machine.

Remote Control

Juicy Player can be controlled from everything around it. Click the Remote Control button in the title bar:

Remote Control popup with OSC and HTTP server toggles and a QR code
Remote Control popup. Toggle OSC and the HTTP server, then scan the QR code with any phone to open the web remote.

Mini Player, Tray & Widgets

Click the Mini Player button (or ⌘/Ctrl+⇧+M) to shrink playback to a compact, always-on-top card — cover, transport, favorite and lyrics, expandable with a click. On macOS with a notch, enable the Notch Mini Player and hover the notch for a hidden control capsule.

Mini player window with cover, track info and controls
The Mini Player. A frosted, always-on-top companion — with synced lyrics if you want them.

Closing the window can keep the player running in the system tray / menu bar, with a right-click menu for transport, DSP, wallpaper and screen-keep-awake. On macOS, a WidgetKit Now Playing widget shows the current track on your desktop with play/favorite controls — plus Siri shortcuts and Spotlight search for your whole library.

Settings Reference

Settings (gear icon, or ⌘/Ctrl+,) is searchable and organized into ten sections:

Settings window showing the Playback and Audio sections
Settings. Ten searchable sections, from audio devices to remote control.
SectionWhat lives here
PlaybackResume last playback, minimize to tray, keep screen on, launch at startup, default player.
AudioOutput device, sample rate and buffer size, per-device Exclusive Mode (bit-perfect), sample-rate limit, LUFS loudness normalization.
LibraryCover and metadata caches, automatic folder monitoring, storage path.
AppearanceLanguage (14 built-in), Now Playing skin selection and the Skin Store, blur tuning, reduce motion, Notch Mini Player.
LyricsMini-player lyrics, synced and plain lyrics typography and colors.
VisualizationHD (GPU) visualizations, pause on focus loss.
OSCRemote control over OSC: protocol, ports, feedback target.
HTTP ServerThe web remote and HTTP API, port configuration.
OthersSettings backup export/import, plus a danger zone for resetting data.
AboutVersion info, review and bug-report shortcuts.

Keyboard Shortcuts

KeyAction
SpacePlay / pause
← / →Rewind / forward 10 seconds
↑ / ↓Previous / next track
EscStop playback · exit visualization · close dialogs
MMute
Num 0 / 1 / 2Random / sequential / repeat-one mode
⌘K / Ctrl KFocus the search field
⌘O / Ctrl OOpen an audio file
⇧⌘O / Ctrl ⇧ OOpen a folder
⌘F / Ctrl FToggle full screen
⇧⌘M / Ctrl ⇧ MToggle the Mini Player
⌘, / Ctrl ,Open Settings
⌘W / Ctrl WClose the window

Media keys and the system media controls work too — on Windows from the lock screen and notification center, on macOS from the Now Playing system HUD.

Supported Formats

Juicy Player plays all the formats you're likely to own: MP3, FLAC, WAV, AIFF, OGG, AAC, M4A, OPUS, WMA, and native DSD (DSF / DFF / SACD ISO). Lossless formats (FLAC / WAV / AIFF) play bit-perfect — with Exclusive Mode there's no resampling and no quality loss. Popular music-video containers (MP4, MKV, MOV and more) play in the All Videos page, with film-look color presets and super-resolution for lower-quality sources.

Note: Monkey's Audio (APE) is not supported — convert your APE library to FLAC for identical quality.

Troubleshooting

My phone can't connect to the computer
  • Make sure both devices are on the same Wi-Fi network. Guest and public Wi-Fi networks often isolate devices from each other.
  • Check that Juicy Player is running on the computer.
  • Allow Juicy Player through the firewall for private networks (Windows usually prompts on first launch — if you missed it, allow it manually in Windows Security → Firewall).
  • If your router has AP isolation enabled, devices can't see each other — disable it in the router settings.
A song won't play
Check the file extension against the supported formats above — note that APE is not supported. If a file still fails, it may use an unusual codec variant; feel free to report it via the contact below.
No lyrics were found for a track
Lyrics come from the lrclib.net database and are saved next to your music as .lrc files. Try the lyrics button again, or right-click a track → Search Lyrics. Instrumentals and very obscure tracks may simply not have lyrics available.
Where can I download older versions?
Every release is archived on GitHub Releases, with changelogs for each version.
Is Juicy Player free? Does it need an account?
The player is completely free — no ads, no subscriptions, no tracking. An account is only used for the optional Juicy Store features (skins and wallpapers), signed in via GitHub. The Juicy Remoter mobile app is a one-time purchase and never needs any account. Your listening history stays on your own computer.
Is Juicy Player available for macOS?
Yes — Juicy Player runs on macOS 15.0 or newer and ships with Mac-exclusive touches: the Notch Mini Player, the Now Playing desktop widget, camera head tracking for spatial audio, and Apple Silicon-native performance. See System Requirements.

System Requirements

AppPlatformRequirement
Juicy Player (desktop)WindowsWindows 10 / 11 · 64-bit (x64) or ARM64
Juicy Player (desktop)macOSmacOS 15.0 or newer
Juicy Remoter (mobile)AndroidAndroid 7.0 or newer
Juicy Remoter (mobile)iOSiOS 15.0 or newer

Contact

Still stuck, found a bug, or have a feature request? Email us at hifior@foxmail.com — we read everything.