Skip to content

Korai Player V1.4

Choose a tag to compare

View all tags
@Behdad-kanaani Behdad-kanaani released this 09 Jun 14:56
v1.4.0
2ce5461

KORAI v1.4 — Plugin System & Home Redesign

Open Source. Local First. Intelligence Built In.

🎯 What's new in v1.4

🔌 Plugin System (Complete Architecture)

KORAI now features a full plugin ecosystem — extend functionality without modifying core code.

  • Isolated execution — Each plugin runs in a sandboxed worker thread (VM + separate process)
  • Permissions system — Plugins must request access (filesystem, network, audio, notifications, clipboard)
  • Performance monitoring — CPU/memory/error tracking per plugin; auto-disable on crash
  • CLI tool — korai-plugin create, pack, validate, dev

Plugin Marketplace UI and Audio Effects UI are framework-ready and coming in v1.5.

🏠 Home Page Redesign (Premium v2.0)

  • Cinematic hero section with particle animation and vinyl disc art
  • Quick stats cards (track count, play time, favorites)
  • Mood chips (horizontal scrollable with icons)
  • Featured grid with responsive CSS Grid
  • Recently added list with hover slide effect

📚 Library Masonry & Virtualization

  • CSS Columns layout for masonry effect
  • Virtual scrolling for large libraries (50k+ tracks tested)
  • IntersectionObserver for lazy image loading

🎨 Visual Upgrades

  • 3D cover art with hover scale/glow
  • Marquee scrolling for long titles
  • Performance mode for low-end devices (auto-detects RAM <4GB, CPU cores <4)
  • Persian/Farsi RTL improvements

🔧 Technical Improvements

  • Crossfade: exponentialRampToValueAtTime (offloaded to audio thread)
  • Visualizer: throttled to 20 FPS, visibility-based rendering
  • Database: write debouncing (100ms), async file writes
  • Memory optimizations for Liquid Glass theme

📦 Downloads

Platform Format Link
Windows (x64) NSIS installer Download

macOS & Linux: Planned (no ETA)

⚠️ Honest limitations

  • Electron-based → ~180-250MB RAM. Not a C++ app, but cross-platform.
  • 5-band EQ, not 10 → Quality over quantity. More bands in v1.5.
  • BPM detection is estimated (±5 BPM) → Great for playlist matching, not lab-grade.
  • Windows only currently → macOS/Linux planned.

🔧 Upgrade from v1.3

  1. Download the installer
  2. Run the setup (your library and settings are preserved in %APPDATA%\korai-player\)
  3. Launch KORAI

📋 Full Changelog

✨ New Features

  • Plugin architecture (PluginManager, PluginHost, PluginWorker with VM sandbox)
  • Plugin CLI tool (korai-plugin create, pack, validate, dev)
  • PluginPerformanceMonitor (CPU/memory/error tracking)
  • Home page redesign (cinematic hero, quick stats, mood chips, featured grid)
  • Library masonry with CSS Columns + virtual scrolling
  • 3D cover art hover effects
  • Marquee scrolling for long titles
  • Performance mode (auto-detects low-end devices)

🔧 Improvements

  • Crossfade: exponentialRampToValueAtTime instead of JS timers
  • Visualizer: reduced to 20 FPS, visibility-based rendering
  • Database: write debouncing (100ms), async file writes
  • Image loading: IntersectionObserver with 200px rootMargin
  • Liquid Glass theme: reduced blur intensity for better performance

🐛 Bug Fixes

  • Worker threads compatibility (analyzer.worker.js)
  • Miniplayer full-window mode (border-radius, background)
  • Z-index stacking (immersive player above playback bar)
  • Missing genre translations (chill, acoustic, latin)

❌ Removed

  • additonal.js (typo) → replaced with additional.js

🙏 Credits

Built with Electron, Express, music-metadata, and lots of coffee.

Download now: KORAI v1.4.0

KORAI — Open source. Local first. Intelligence built in.

Assets 3
Loading