Skip to content

Repository files navigation

Luniq Logo

─── ✧ L U N I Q   M U S I C ✧ ───

Luniq is an open-source desktop music player made by Saraans. It's not trying to be everything just the one app you actually want to open when you want to listen to music. We made it because most players feel like they were designed for everyone except you. No fuss, no clutter. Just your music, the way it should be :3


License: GPL v3 Platform: Desktop Version 2.0.1 Discord


Luniq Hero

/ Download

Or grab the latest setup directly from Releases.


/ Development

git clone https://github.com/saraansx/Luniq-Music.git
cd Luniq
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

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

  • Logic: React 18 + TypeScript
  • Desktop Foundation: Electron 42
  • 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.

/ Globalization

Help us sprinkle some magic and translate Luniq into your language!

Translation status

Translation status

/ Support

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


/ Engagement

Track our project growth over time and view interactive star history data!

Star History Chart


/ License

Luniq 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.


✦ Luniq Music by Saraans ─ Crafted for the Aesthetic Listener ✦

About

Tired of interruptions? Luniq is a sleek, open-source music player built for a seamless listening experience. ✦

Resources

Code of conduct

Contributing

Stars

123 stars

Watchers

2 watching

Forks

Releases

Contributors

Languages