Skip to content

saraansx/Lune

Lune Logo

─── ✧ L U N E ✧ ───

Lune is a lightweight, open-source desktop music player that leverages Spotify's metadata to deliver ad-free streaming with smart autoplay capabilities, entirely without the need for a paid subscription. Built for performance and beautifully designed, it offers a fast and distraction-free environment for your entire music library.


License: GPL v3 Platform: Desktop Version 1.0.0 Discord


Lune Hero
Lune Interface 2 Lune Interface 3
Lune Interface 1

/ Download

Windows Windows - WinGet winget install saraansx.Lune
Windows Windows - Chocolatey choco install lune
Windows Windows - Scoop scoop bucket add extras
scoop install lune

Or grab the latest setup directly from Releases.


/ Development

git clone https://github.com/saraansx/Lune.git
npm install
npm run dev

/ Features

  • Ad-Free — High-quality streaming without a paid subscription.
  • Offline — Save any track, album, or playlist for high-speed offline playback.
  • Library — Seamlessly mix local music with your Spotify collections.
  • Lyrics — Real-time scrolling lyrics support powered by LRCLib.
  • Discord — Built-in Rich Presence to share your current track with friends.
  • Design — Minimalist interface with customizable HSL-based accent colors.
  • Performance — Fast, smooth scrolling even with thousands of saved tracks.
  • Localization — Fully translated into multiple languages including English and Hindi.
  • Optimized — Native media keys, smart caching, and automatic updates.

/ Tech Stack

Lune is built on a modern, high-performance stack designed for the desktop:

  • Logic: React 18 + TypeScript
  • Desktop Foundation: Electron 30
  • Build Tooling: Vite 5
  • Database: Better-SQLite3 for persistence and unified library management.
  • Audio Engine: yt-dlp for optimized stream harvesting and download management.
  • Presence: Discord-RPC for seamless social integration.
  • Styling: Pure, high-performance Vanilla CSS with a focus on modern glassmorphism and HSL-based design systems.

/ Support

Enjoying Lune? Consider giving us a ⭐ to support the development and join our Discord for updates!


/ Engagement

Star History Chart


/ License

Lune is proudly open-source and licensed under the GPL-3.0 License.

This ensures that the project remains free and open. Any modifications or derivative works distributed to others must also be open-source and released under the same license.


✦ Lune ─ Crafted for the Aesthetic Listener ✦

About

Lune ad-free Open Source Spotify Client Music Player for Desktop. Built with React & Electron ✦

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Contributors

Languages