by nukeop

nukeop / nuclear

Streaming music player that finds free music for you

5.8K Stars 591 Forks Last release: Not found GNU Affero General Public License v3.0 1.9K Commits 20 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Maintainability Codacy Badge nuclear Travis

Desktop music player focused on streaming from free sources



Official website



Support channel (Matrix):

Discord channel:

Readme translations: * Brazilian Portuguese * Swedish

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), 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

Manual and docs

Community-maintained packages

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

| Package type | Link | Maintainer | |:--------------:|:-------------------------------------------------------:|:---------------------------------------------:| | AUR (Arch) | | mikelpint | | Choco (Win) | | JourneyOver | | Homebrew (Mac) | | Homebrew | | Snap | | nukeop | | Flatpak | | advaithm |

big thanks to ayyeve for letting me (advaithm) use her server as a compile machine.

Community translations

Nuclear has already been translated to several languages, and we're always looking for contributors who would like to add more. Below is a list of currently available languages, along with contributors who helped to translate Nuclear to that language.

| Language | Contributor | |:--------------------:|:----------------------------------------------------------------------------------------------------:| | English | N/A | | French | charjac, Zalax | | Dutch | Vistaus | | Danish | Hansen1992 | | Spanish | mlucas94, emlautarom1 | | Polish | kazimierczak-robert, gradzka | | German | schippas | | Russian | ramstore07, dmtrshat | | Brazilian Portuguese | JoaoPedroMoraes | | Turkish | 3DShark | | Italian | gello94 | | Slovak | MartinT | | Czech | PetrTodorov | | Tagalog | giftofgrub | | Traditional Chinese | oxygen-TW | | Swedish | PalleKarlsson | | Greek | Shuin-San |

Development process

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

Use npm:

$ npm install # installs dependencies
$ npm start

A new window should open that will load the web app and run Nuclear.

To build for current operating system:

$ lerna bootstrap
$ npm run build

Instead of

you can use
to build for all operating systems. The binaries will be in

It's also possible to run the development environment using docker containers, but this should be considered experimental.

You will need docker and docker-compose. You need to allow the root user to connect to X11 display, and then you can run docker-compose:

$ xhost SI:localuser:root
$ sudo docker-compose up dev

As of now you can also build a flatpak version. You will need to install gobject-introspection, and flatpak-builder. After this you will need to install the runtimes and depedencies required by flatapk-builder for the compile process. You will need the 19.08 version of these flatpaks.

$ flatpak install flathub org.freedesktop.Platform
$ flatpak install flathub org.freedesktop.Sdk
$ flatpak install flathub io.atom.electron.BaseApp
Next, to build the project (use the
flag to get more output):
$ flatpak-builder build-dir org.js.nuclear.Nuclear.json
To run the built app:
$ flatpak-builder --run build-dir org.js.nuclear.Nuclear.json
You can turn the app to a local repo. currently the file builds the latest release.


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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.