🚀 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 Musictitle 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:
- Title Match (45 pts): Automatically strips noise tags like
(Live),[Karaoke],(Remix). - Artist Match (30 pts): Detects duets, aliases, and featured artists.
- Duration Precision (25 pts): High accuracy if duration difference is
< 1s. - Color Badges: Shows
98% Matchbadges 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
MusicandDownload/JuJuDownload(the cloud-download root, which contains theJuJuCacheplayback cache) in local storage, and always includes the P2P receive folderDownload/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
MusicandDownload/JuJuDownload(including theJuJuCacheplayback cache) by default, and always includes the P2P receive folderDownload/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 …), andAliyun 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/S3put 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/SMBuse a plain hostname / IP and therefore keep a port field (default 21 / 22 / 445, usually left blank).
- Where the port goes: for
- 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, missingFRTE, or DST >6 channels are skipped. - Storage: on Android 11+, local
.wv/.tta/.tak/.mpcfiles need the all-files access permission, or play via cloud/sync/share;.wmais indexed by the system media library.
We never claim “all formats”; the scan-filter list and these limits are authoritative.