Lune

Lune 1.0.3

Ad free Spotify client for desktop. Stream, download, and own your listening experience

  • By Lune Devs
  • Open Source
  • Updated Apr 14, 2026
Download for Windows

About Lune

Ad free Spotify client for desktop. Stream, download, and own your listening experience

What's new in 1.0.3

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.

Full release notes »

Technical details

PublisherLune Devs
Version1.0.3
Release date2026-04-14
LicenseGPL-3.0
Installer typenullsoft
Architecturex64
Package IDsaraansx.Lune

Install Lune from the command line

Install with Windows Package Manager
winget install --id=saraansx.Lune -e
Update to the latest version
winget upgrade --id=saraansx.Lune -e
Uninstall
winget uninstall --id=saraansx.Lune -e
Silent install with the offline installer
"Lune-Setup-1.0.3.exe" /S

Silent install switches for more Windows programs »

Install Lune together with other apps in one command »

Lune version history

1.0.2 Mar 12, 2026

[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). …

1.0.1 Mar 5, 2026
1.0.0

Frequently asked questions

Is Lune free?

Yes. Lune is free and open-source software released under the GPL-3.0 license.

What is the latest version of Lune?

The latest version is 1.0.3, released on Apr 14, 2026.

Is it safe to download Lune?

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.

Which Windows versions does Lune support?

Lune runs on Windows and is available for 64-bit (x64) systems.

How do I install Lune silently?

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.

How do I uninstall Lune?

Open Settings › Apps › Installed apps, find Lune and select Uninstall. From the command line, run winget uninstall --id=saraansx.Lune -e.