About Lune
Ad free Spotify client for desktop. Stream, download, and own your listening experience
Ad free Spotify client for desktop. Stream, download, and own your listening experience
Ad free Spotify client for desktop. Stream, download, and own your listening experience
Changelog
All notable changes to Lune will be documented in this file.
[1.0.3] - 2026-03-14
Self-Healing Authentication & Session Resiliency
This update introduces a robust, proactive authentication system that automatically recovers from expired Spotify tokens and transient network failures, ensuring uninterrupted playback and account access.
Added
- Dynamic Languages Support: Added support for dynamically loading translations and changing the application language.
- Windows Taskbar Controls (Thumbar): Added a native Windows thumbnail toolbar with quick-access playback controls (Previous, Play/Pause, Next) you can use while hovering over the app icon.
- Real-time 401 Error Detection: The application now actively monitors all Spotify API requests for "Unauthorized" (401) responses. If a session expires while the app is running, it instantly triggers a background recovery instead of waiting for a scheduled timer.
- Proactive Token Refresh: Implemented a global onUnauthorized hook that bridges all API endpoints to the main authentication controller, allowing for immediate "self-healing" of the application state.
Changed
- Progress Bar UI Refinement: Improved the visual design of the player bar by resizing the progress bar to make it larger and easier to click.
- Improved Session Resiliency: Refactored the authentication lifecycle in main.tsx to hold onto user credentials during transient errors. The app no longer "gives up" on a session due to a single failed refresh, preventing users from being kicked to the "Log out anyway" setting state.
- Bypassable Refresh Cooldown: Modified the Electron background process to ignore the standard 10-second refresh cooldown if a hard 401 error is detected, ensuring music playback and settings can recover the millisecond a connection is restored.
Fixed
- Clear Queue Logic: Fixed a bug where clicking the "Clear Queue" button wouldn't properly clear the list if Shuffle mode was enabled.
- Persistent "Log out anyway" Bug: Fixed a logic error where the app would mark a session as invalid if a background refresh failed once, which previously forced users to manually log out and back in to fix the "Could not load profile" error in settings.
- Refresh Timer Suspension: Corrected a bug in the token refresh logic where an already-expired token would wait 5 minutes to retry; it now retries in the background with increasing frequency while keeping the UI active.
| Publisher | Lune Devs |
|---|---|
| Version | 1.0.3 |
| Release date | 2026-04-14 |
| License | GPL-3.0 |
| Installer type | nullsoft |
| Architecture | x64 |
| Package ID | saraansx.Lune |
winget install --id=saraansx.Lune -ewinget upgrade --id=saraansx.Lune -ewinget uninstall --id=saraansx.Lune -e"Lune-Setup-1.0.3.exe" /S[1.0.2] - 2026-03-12
Remote Plugin System & Reliability Overhaul
This update eliminates the need for app updates when Spotify changes their API hashes, fixes critical YouTube playback failures, and adds a full Downloads management experience.
Added
- Gapless Autoplay Transition: The AutoplayQueue radio tracks are now fully integrated into the stream prefetcher. When the player queue falls back to the autoplay list, the next track's audio is fetched in the background before the current song finishes, ensuring instant gapless playback transitions.
- Backend Application Logs: Internal application logs, including the Rate Limiter, Radio Pool engine, and Stream Prefetcher, are now dynamically intercepted from the React frontend and bridged directly into the Electron main process logs for easier debugging in the Lune Settings.
- Remote Hash Registry: All Spotify GraphQL persisted-query hashes are now fetched from a remote GitHub Gist at runtime instead of being hardcoded. If a hash breaks, it can be fixed by editing the gist — no app update required. Hashes are cached in memory with a 30-minute TTL, with graceful fallback to stale cache if the remote fetch fails.
- Downloads View: Brand new dedicated Downloads page with full track listing, virtualized scrolling (handles thousands of tracks), shuffle play, queue management, and per-track context menus (play next, add to queue, favorite, add to local playlist, remove download). …
Yes. Lune is free and open-source software released under the GPL-3.0 license.
The latest version is 1.0.3, released on Apr 14, 2026.
The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with e122dc11515b2519ec0893f42d0456b4fe436668e0525ad3b9578a9b5f03163e.
Lune runs on Windows and is available for 64-bit (x64) systems.
Run the offline installer with "Lune-Setup-1.0.3.exe" /S, or install it with Windows Package Manager: winget install --id=saraansx.Lune -e --silent.
Open Settings › Apps › Installed apps, find Lune and select Uninstall. From the command line, run winget uninstall --id=saraansx.Lune -e.