Streaming music player that finds free music for you
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
bannan938 7c4d5a0712
Update download.ts (#1431)
1 week ago
.github Update release action 1 month ago
__mocks__ Feature/jest in core (#899) 2 years ago
build Update icons 11 months ago
docs Add Japanese readme (#1425) 3 weeks ago
flatpak Updated flatpak build and readme to point to the flathub page 3 years ago
packages Update download.ts (#1431) 1 week ago
.env Fix Discord Rich Presence - update client ID 5 months ago
.eslintrc.json Disable unused vars rule 7 months ago
.gitattributes chore(build): add back icons 3 years ago
.gitignore Resolution for Issues #1044 & #1007 (#1057) 2 years ago Update 2 years ago
Dockerfile add npm script to build and run nuclear:prod using docker (#173) 4 years ago Convert to lerna monorepo (#485) 4 years ago Rename LEGAL to (#235) 4 years ago
LICENSE Create LICENSE 5 years ago Update 5 months ago
codecov.yml Make code coverage stats informative 5 months ago
crowdin.yml Update Crowdin configuration file 2 years ago
docker-compose.yml Convert to lerna monorepo (#485) 4 years ago
lerna.json Suppress test warnings 8 months ago
logo.png Add snapcraft banner to resources 3 years ago
package-lock.json Update package-lock 4 weeks ago
package.json Update sqlite3 package to fix install error on macOS with Apple Silicon 5 months ago
tsconfig.json Downloads tests and improvements (#1116) 1 year ago


nuclear Discord

Desktop music player focused on streaming from free sources



Official website





Support channel (Matrix):

Discord chat:

Suggest and vote on new features here:

Readme translations:

Deutsch Português Svenska English Hebrew Italiano Türkçe Español Indonesia Français Chinese Russian Polski Hindi

What is this?

nuclear is a free music streaming program that pulls content from free sources all over the internet.

If you know mps-youtube, this is a similar music player but with a GUI. It's also focusing more on audio. Imagine Spotify which you don't have to pay for and with a bigger library.

What if I am religiously opposed to Electron?

See this.


  • Searching for and playing music from YouTube (including integration with playlists and SponsorBlock), Jamendo, Audius and SoundCloud
  • Searching for albums (powered by and Discogs), album view, automatic song lookup based on artist and track name (in progress, can be dodgy sometimes)
  • Song queue, which can be exported as a playlist
  • Loading saved playlists (stored in json files)
  • Scrobbling to (along with updating the 'now playing' status)
  • Newest releases with reviews - tracks and albums
  • Browsing by genre
  • Radio mode (automatically queue similar tracks)
  • Unlimited downloads (powered by youtube)
  • Realtime lyrics
  • Browsing by popularity
  • List of favorite tracks
  • Listening from local library
  • No accounts
  • No ads
  • No CoC
  • No CLA

Development process

First of all, be sure to check out the Contribution Guidelines.

The instructions for running Nuclear in development mode can be found in the Development Process document.

Community-maintained packages

Here's a list of packages for various managers, some of which are maintained by third parties. We would like to thank the maintainers for their work.

Package type Link Maintainer Installation Method
AUR (Arch) nukeop yay -s nuclear-player-bin
AUR (Arch) nukeop yay -s nuclear-player-git
Choco (Win) JourneyOver choco install nuclear
GURU (Gentoo) Orphaned emerge nuclear-bin
Homebrew (Mac) Homebrew brew install --cask nuclear
Snap nukeop sudo snap install nuclear
Flatpak nukeop flatpak install flathub org.js.nuclear.Nuclear
Void Linux machadofguilherme See readme

Community translations

Nuclear has already been translated to several languages, and we're always looking for contributors who would like to add more.

We're using Crowdin to manage localization. You can check if your language is supported, track localization progress, and help us translate Nuclear there.


This will be updated as the program evolves.

Album Search

Album Display

Artist View

Dashboard Best New Music

Dashboard Genres

Playlist View

Lyrics View

Equalizer View


This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.


Uses SponsorBlock data licensed used under CC BY-NC-SA 4.0 from