v0.1.0

Veluna v0.1.0 - Initial Release 🎵

Veluna wraps the power of mpv as its audio engine and yt-dlp as its streaming backend inside a lightweight Tauri v2 shell (Rust + React 19). The result is a lightning-fast player with near-zero resource overhead and full desktop environment integration.

---

🚀 Key Features

🔍 Streaming & Search

• Instant YouTube Streaming: Search YouTube directly within the app and stream audio instantly via yt-dlp and mpv IPC — zero video bandwidth, zero buffering delay.
• Search History: Access a quick-pick dropdown of your last 8 queries.
• Quick Picks: Instantly replay your 20 most recently played tracks from the home screen.
• Genre Shelves: Home screen automatically detects genres from your listening history and clusters your tracks into scrollable shelves (Hip-Hop, Synthwave, Lo-Fi, Pop, Rock, EDM, and more).

📁 Offline Library & Downloads

• Local Library Scanning: Point Veluna at any folder to scan local audio. Metadata is scanned and enriched in the background without UI lag.
• Offline Playback: Full filter-as-you-type search, real-time drag-and-drop reordering, and direct file management (rename files on disk, delete tracks, or show in system file manager).
• High-Quality Downloader: Save any YouTube track with one click. Select your audio format (MP3, Opus, M4A, FLAC) and quality (High 320kbps+, Medium, Low).
• Embed Metadata: Automatically writes cover art, titles, artists, and album tags directly into file ID3/MP4 metadata.
• Duplicate Detection: Smart scanner checks your destination folder before starting downloads to prevent downloading duplicates.

🎵 Playlists & Queue

• Playlists Manager: Create, edit, and reorder playlists. Add custom cover artwork.
• Smart Playlists: Built-in "Liked Songs" playlist updated via simple heart toggles across the app.
• Spotify Import: Upload a Spotify playlist CSV (exported via exportify.net). Veluna matches each track concurrently and displays matching progress in a minimizable background modal.
• YouTube Import: Paste any public YouTube playlist URL for instant queueing or saving.
• Persistent Queue: Queue orders and items are persisted automatically across sessions.

🎤 Lyrics & Immersion

• Scrolling Synced Lyrics: Real-time line-by-line synced lyrics highlighting and click-to-seek support.
• Immersive Fullscreen View: Visual layout featuring blurred album art background, control widgets, audio output switcher, and scrolling lyrics.
• Multi-Source Fallbacks: Select your primary lyrics source (lrclib, Musixmatch, or NetEase) with automatic fallbacks.

🔊 Audio Engine & Output

• mpv Backend: Robust playback supporting Named Pipes (Windows) and Unix Sockets (Linux).
• Live Output Switcher: Switch active audio output devices instantly (headphones, speakers, HDMI) without restarting playback or restarting mpv.
• Audio DSP: 3-Band Equalizer (bass, mid, treble adjusted live), EBU R128 loudness normalization, skip silence filter, and seek-bar waveform visualization for local files.
• Playback Speed & Loops: Control playback speeds (0.5× to 2.0×) and loop specific segments via A-B looping.

---

📦 Installation Guide

🐧 Linux — Debian / Ubuntu / Mint (.deb)

The Debian package automatically registers runtime dependencies and desktop application links.

1. Download the veluna_0.1.0_amd64.deb package.
2. Install the package using apt so system dependencies are resolved:

   sudo apt install ./veluna_0.1.0_amd64.deb
   

🐧 Linux — Fedora / RHEL / CentOS (.rpm)

1. Download the veluna-0.1.0-1.x86_64.rpm package.
2. Install using dnf:

   sudo dnf install ./veluna-0.1.0-1.x86_64.rpm

🪟 Windows (.exe)

1. Download the veluna_0.1.0_x64-setup.exe installer.
2. Run the installer and follow the setup wizard.
3. If Windows SmartScreen warns you, click More info → Run anyway. This happens because the app isn't code-signed yet. Why?