🎵 KORAI Music Player - Release Notes v1.3.0
"Visual Intelligence Update" | June 4, 2026
🚀 Major New Features
🎨 Visual Intelligence (Desktop-first)
| Feature |
Description |
| 3D Cover Art |
Hover any album cover — it scales, glows, and reacts to your cursor with realistic shadows and CSS 3D transforms |
| Live Waveform Timeline |
45 animated bars that pulse with your music using requestAnimationFrame |
| Marquee Scrolling Text |
Long song titles (12s) and artist names (15s) scroll smoothly when they don't fit |
| Artist Cards View |
Browse by artist with album art, track counts, and a "Play All" button |
| Spectrum Analyzer |
Live frequency visualization in the stats panel |
🔄 Playback Modes (Finally Complete)
| Mode |
Description |
| Repeat One |
Loop a single track — three modes: None, All, One |
| Smart Shuffle |
History tracking prevents immediate repeats. Works across library, playlists, favorites, and artist views |
⚡ Performance & Quality of Life
- Performance Mode — Auto-detects low-resource devices (RAM <4GB, CPU cores <4) and reduces animations to keep playback smooth
- Version Badge — Shows current version with red, pulsing indicator when updates are available
- Auto-Update Notification — Checks every 24 hours. One click to download the latest version
- Song Info Modal — Full metadata display (BPM, energy, bitrate, sample rate) at a glance
- Better Drag & Drop — Visual feedback when dropping files into the player
🔧 Improvements & Fixes
| Category |
Details |
| Code Cleanup |
Removed ~1,200 lines of low-quality code (including unreliable karaoke) |
| analyzer.js |
Faster and more accurate metadata extraction |
| recommender.js |
Better similarity scoring for local recommendations |
| Shuffle Logic |
Fixed — now respects lastPlaySource (library, playlist, favorites, artist) |
| Timeline Visualizer |
Fixed lag, reduced from 55 to 45 bars for better performance |
| Mini-player |
Fixed sync issues |
| Search Filters |
Improved accuracy |
❌ Removed Features
| Feature |
Reason |
| Karaoke Mode |
Removed due to poor quality. We don't ship features that don't work well. High-fidelity vocal extraction coming in v1.4 |
📦 Technical Changes (Developers)
New Files
src/backend/updater.js - Auto-update notification engine
src/frontend/additional.css - v1.3 visual upgrades (539 lines)
src/frontend/additonal.js - v1.3 UI handlers (3D cover, waveform, marquee)
Files Changed
12 files changed
+2,400 lines added
-3,600 lines removed
📊 Net change: ~1,200 lines removed (simpler, cleaner, faster)
Version Update
package.json: 1.2.0 → 1.3.0
📊 Feature Comparison (v1.3 vs Others)
| Feature |
KORAI v1.3 |
Spotify |
Apple Music |
VLC |
| 3D Cover Art with hover |
✅ |
❌ |
❌ |
❌ |
| Live Waveform Timeline |
✅ |
❌ |
❌ |
❌ |
| Marquee Scrolling Text |
✅ |
❌ |
❌ |
❌ |
| Repeat One Mode |
✅ |
✅ |
✅ |
✅ |
| Smart Shuffle with history |
✅ |
✅ |
✅ |
❌ |
| Performance Mode (low-end) |
✅ |
❌ |
❌ |
❌ |
| Version Badge + Auto-update |
✅ |
✅ |
✅ |
❌ |
| Artist Cards View |
✅ |
✅ |
✅ |
❌ |
🎯 What Makes KORAI v1.3 Different
No other open source player looks like this. No other player combines privacy with this level of visual polish.
| Aspect |
KORAI v1.3 |
Others |
| Visuals |
3D covers, live waveform, marquee text |
Static lists or basic grids |
| Privacy |
Zero telemetry, open source |
Closed source, data collection |
| Cost |
Free forever |
Subscription or limited free tier |
| Playback |
Repeat One + Smart Shuffle |
Often missing one or both |
🐛 Known Issues in v1.3.0
| Issue |
Status |
| macOS/Linux builds |
🚧 Planned for future release |
| High-fidelity vocal extraction |
🔄 Coming in v1.4 |
| BPM detection ±3 BPM tolerance |
✅ Works great for playlist matching, not lab-grade |
📥 Download
| Type |
File |
| Setup (installer) |
KORAI-Setup-1.3.0.exe |
🔧 System Requirements
| Component |
Minimum |
| OS |
Windows 10 (64-bit) |
| RAM |
512 MB (4GB+ recommended for Performance Mode off) |
| Storage |
200 MB |
| Audio |
Web Audio API support |
⌨️ Keyboard Shortcuts (v1.3)
| Shortcut |
Action |
| Space |
Play / Pause |
| ← / → |
Seek -10s / +10s |
| Ctrl + ← / Ctrl + → |
Previous / Next |
| ↑ / ↓ |
Volume +10% / -10% |
| M |
Mute |
| F |
Toggle fullscreen |
| Esc |
Exit fullscreen |
| Ctrl + K |
Focus search |
| Ctrl + L |
Focus library |
| N |
Next track |
| B |
Previous track |
| S |
Stop |
| R |
Cycle repeat modes (None → All → One) |
Media keys (Play, Pause, Next, Previous) work on all platforms.
👨💻 Developer
Behdad Kanaani
Teenage programmer, music enthusiast, AI & computer vision lover
GitHub: @Behdad-kanaani
📄 License
Apache License 2.0 + Commons Clause
Non-commercial use only. Full license text in repository.
⭐ Support the Project
If you enjoy KORAI Music Player, please star the repository on GitHub!
Built with ❤️ by Behdad Kanaani
First of the KORAI Wave
Local-first. Privacy-first. Intelligence built-in.
