🚀 Quick Start: Visual Indicators & Hidden Gestures Map

Welcome to JuJu Music! A cyberpunk-themed local and private cloud music player crafted for audiophiles and power users.

This guide reveals the core status indicator cues, intuitive gestures, and hidden geek mechanics in 3 minutes.


🔍 1. Decoding App Status: Visual Indicator Secrets

JuJu Music integrates dynamic visual cues directly into UI components without intrusive popups:

UI Element Visual State Hidden Meaning / System Behavior
Top Settings Gear ⚙️ Neon Pink + rotating An async background task is running during app cold start or a manual library refresh (full audio scan, cloud sync comparison, metadata writing). Cyber Cyan and static means idle and ready.
Toolbox Icon 🔧 (a monochrome vector wrench icon in the app; 🔧 is just a stand-in here) Neon Pink vs Cyber Cyan Tracks the voice assistant state: Neon Pink while the assistant is enabled and listening, Cyber Cyan when it is off. This is unrelated to the EQ or the sleep timer.
Player Screen · Song Info Button Neon Pink vs Cyber Cyan Same signal — it follows the voice assistant state and stays in sync with the toolbox icon.
Vinyl Center Number Digit value + digit colour The digit is the user's Sound Energy Growth Level (0–7), advancing with total playtime: 0 Launch → 1 Voyager → 2 Harmonizer → 3 Navigator → 4 Sonic Master → 5 Fusion Master → 6 Cyber Grandmaster → 7 Apex Resonance. Full progress and vitality live in the Pro toolbox dashboard "User Level & Vitality" (Pro incl. trial); on the Free Edition the toolbox shows a single-row entry that still opens the level-scale explanation (levels and vitality keep accumulating in the background and light up the moment you go Pro).
The colour of that digit signals lyrics: Cyber Cyan = the current track has lyrics (embedded or a separate .lrc file, both scroll), Neon Pink = no lyrics.
Note the distinction: the ring around the digit is always Cyber Cyan and never changes; it is the digit itself that changes colour.
Lyrics View · Active Line Color Cyber Cyan vs Neon Pink Cyber Cyan: the lyrics come from inside the audio file (embedded). Neon Pink: the lyrics come from a separate .lrc file. Tells you at a glance whether to edit the file or switch the lyric source.
Title Dynamic Gradient Pink ratio + flow speed The proportion of Neon Pink in the top JuJu Music title maps your recent 3-day Vitality Index in real time, with flow speed reflecting activity changes. This gradient is Pro-only (trial included); the Free Edition keeps the classic pure-cyan title while vitality still accumulates in the background.

⚡ 2. Hidden Geek Gestures: Frictionless Control

1. Toggle Vinyl Cover and Fullscreen Lyrics

  • Two-finger Double Tap: On the playback screen, double-tap with two fingers anywhere to instantly toggle between the spinning vinyl and fullscreen glowing lyrics.
  • Swipe Left to Right: In the lyric view, swipe smoothly from left to right to return to the vinyl cover.
  • Tap Top Header: Tapping the top "JuJu Music" title also toggles between cover and lyrics.

2. Precise Lyric Timestamp Seeking

  • Double-tap Any Lyric Line: Double-tap any lyric line to instantly jump playback to that exact timestamp.

3. Header Double-Tap: Manual Wake-Up

  • Double-tap the whole header: double-tap anywhere on the JuJu Music title to manually wake the voice assistant, which immediately starts listening and recording — this works whether or not always-on wake-up is enabled.
  • The always-on switch lives only in the toolbox: Toolbox → "AI Features" → "Enable voice wake-up"; turning it on warns about battery use and false wake-ups.

The header is no longer split into left and right halves (the right-half always-on toggle was removed), so a stray double-tap cannot switch the background service off.


🎵 3. Smart Weighted Lyric Matching Engine

JuJu Music aggregates lyrics from major music platforms with a 100-point multi-dimensional scoring algorithm:

  1. Title Match (45 pts): Automatically strips noise tags like (Live), [Karaoke], (Remix).
  2. Artist Match (30 pts): Detects duets, aliases, and featured artists.
  3. Duration Precision (25 pts): High accuracy if duration difference is < 1s.
  4. Color Badges: Shows 98% Match badges in candidate lists. Long-press track to manually switch lyric sources.

🎛️ 4. Professional Equalizer & Smart Peak Guard

  • Genre Presets: Rock, Pop, Jazz, Classical, Bass Boost, Vocal Enhancer with genre auto-switching.
  • ReplayGain (-3.0dB): Normalizes loudness across tracks to prevent sudden volume spikes.
  • Smart Peak Guard: Built-in dynamic limiter suppresses distortion under heavy bass boost.

🔍 5. Library Categories & Instant Filtering

  • Multi-level categories: browse by All Songs, Artist, Album, Genre, and Folder.
  • Always-on filter box: a persistent search field sits at the bottom of the category list and filters as you type. It matches song title, artist name, and file name (case-insensitive substring match).
  • Default scan folders: on first install the app scans Music and Download/JuJuDownload (the cloud-download root, which contains the JuJuCache playback cache) in local storage, and always includes the P2P receive folder Download/JuJuReceived. Any other folder must be added manually under Settings -> Local -> Add Folder.
  • Bulk track operations: tap the plus icon (+) on any artist or album row to add every song in that category to the current queue or to a chosen playlist at once.

🔧 6. Toolbox & Settings Quick Reference

1. The toolbox entries

Tap the toolbox icon 🔧 in the top-right corner of the main screen (36dp; its color reflects the voice assistant state described above):

Entry Purpose
User Level & Vitality Sound Energy level, recent 3-day vitality, cumulative play count and growth progress (Pro incl. trial; on the Free Edition this row is an entry hint that opens the level-scale explanation)
Receive Shared Song Enter a 6-digit pickup code to receive a song shared over P2P
Cloud Folder Sync Manage one-way / two-way incremental sync tasks between cloud and local folders
Cloud Online Play Browse the cloud drive and play on tap, no download needed (Pro incl. trial)
Cloud Song Download Save cloud songs to a local folder for offline listening (Pro incl. trial)
Sound Effects & Equalizer EQ presets, ReplayGain, Smart Peak Guard anti-clipping
Song Sorting Switch the sort field and ascending / descending order
AI Features Voice assistant master switch, the LLM used for voice command parsing (tap Configure for the AI settings page), AI tag completion, AI cover completion
Home Quote Customize the scrolling quote at the top of the home screen

The three cloud entries live in the toolbox (Online Play / Song Download used to be hidden at the bottom of Settings → Cloud, where few people found them). The three buttons on that settings page are still there and lead into exactly the same flows.

2. Settings worth knowing

  • Local Storage: scans Music and Download/JuJuDownload (including the JuJuCache playback cache) by default, and always includes the P2P receive folder Download/JuJuReceived; other folders are added manually.
  • Cloud Mounting: supports FTP / FTPS, Samba (SMB/CIFS), SFTP, WebDAV, Subsonic / Navidrome (read-only, cloud → device only), S3 (MinIO / Ceph / R2 / B2 / COS / OSS …), and Aliyun Drive — the add form lists them in exactly that order; cloud tracks can be cached to the local device, and cloud folders can be synced one-way or two-way with local folders.
    • Where the port goes: for WebDAV / Subsonic / S3 put it in the address (e.g. http://192.168.1.10:5005), which is why the form has no separate port box for them; FTP / SFTP / SMB use a plain hostname / IP and therefore keep a port field (default 21 / 22 / 445, usually left blank).
  • AI Configuration: with an LLM API key entered, it powers the voice assistant's speech recognition and voice command parsing, plus AI song tag completion.
  • Each row in the Download category has a single trash-can icon, never two side by side: 🧹 Clear Directory Content appears only on the default cache folder JuJuCache (that is the stream-while-listening folder for cloud playback and cannot be deleted, so clearing is the only way to reclaim space); custom download folders get 🗑 Delete Download Directory instead, which removes the folder together with its songs — recreate it with the same name if you want to keep the name. Both ask for confirmation first.

📦 7. Supported Formats & Limits

We support 21 mainstream audio suffixes: MP3, FLAC (incl. 32-bit), WAV, AAC, M4A (incl. ALAC), OGG, OGA, OPUS, APE, DSF, MKA, M4B, AIFF/AIF/AIFC, WavPack (.wv, incl. DSD), TTA, TAK, Musepack SV8 (.mpc), DFF and WMA.

A suffix does not imply one codec. The boundaries (also shown as ①②③④ in the scan filter):

  • WMA: WMA 7/8/9 Standard, WMA Pro and WMA Lossless; no DRM-encrypted files or WMA Voice; subject to sample-rate / channel / bit-depth capability checks.
  • MPC: SV8 only, no SV7.
  • TTA: 8/16/24-bit only, no encrypted TTA.
  • DFF: uncompressed DSD and DST ≤6 channels; unknown CMPR, missing FRTE, or DST >6 channels are skipped.
  • Storage: on Android 11+, local .wv/.tta/.tak/.mpc files need the all-files access permission, or play via cloud/sync/share; .wma is indexed by the system media library.

We never claim “all formats”; the scan-filter list and these limits are authoritative.