Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/nukeop/nuclear

Streaming music player that finds free music for you
https://github.com/nukeop/nuclear

electron linux mac music music-player stream streaming windows youtube

Last synced: 29 days ago
JSON representation

Streaming music player that finds free music for you

Lists

README 

        
# ![nuclear](https://i.imgur.com/oT1006i.png) 

[![nuclear](https://snapcraft.io//nuclear/badge.svg)](https://snapcraft.io/nuclear) [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/JqPjKxE)



Desktop music player focused on streaming from free sources



![Showcase](https://i.imgur.com/8qHu66J.png)



# Links



[Official website](https://nuclear.js.org)



[Downloads](https://github.com/nukeop/nuclear/releases)



[Documentation](https://nukeop.gitbook.io/nuclear/)



[Mastodon](https://fosstodon.org/@nuclearplayer)



[Twitter](https://twitter.com/nuclear_player)



Support channel (Matrix): `#nuclear:matrix.org`



Discord chat: https://discord.gg/JqPjKxE



Suggest and vote on new features here: https://nuclear.featureupvote.com/



Readme translations: 



[Deutsch](docs/README-de.md)

[Português](docs/README-ptbr.md)

[Svenska](docs/README-se.md)

[English](README.md)

[Hebrew](docs/README-he.md)

[Italiano](docs/README-it.md)

[Türkçe](docs/README-tr.md)

[Español](docs/README-es.md)

[Indonesia](docs/README-id.md)

[Français](docs/README-fr.md)

[Chinese](docs/README-zh-cn.md)

[Japanese](docs/README-ja.md)

[Russian](docs/README-ru.md)

[Polski](docs/README-pl.md)

[Hindi](docs/README-hi.md)

[Arabic](docs/README-ar.md)



## 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](https://github.com/mps-youtube/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](docs/electron.md).



## Features



- Searching for and playing music from YouTube (including integration with playlists and [SponsorBlock](https://sponsor.ajay.app/)), Jamendo, Audius and SoundCloud

- Searching for albums (powered by Last.fm 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 last.fm (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

- Audio normalization

- No accounts

- No ads

- No CoC

- No CLA



## Development process



First of all, be sure to check out the [Contribution Guidelines](https://nukeop.gitbook.io/nuclear/contributing/contribution-guidelines).



The instructions for running Nuclear in development mode can be found in the [Development Process](https://nukeop.gitbook.io/nuclear/developer-resources/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)     | https://aur.archlinux.org/packages/nuclear-player-bin/             | [nukeop](https://github.com/nukeop)          | yay -S nuclear-player-bin                     |

| AUR (Arch)     | https://aur.archlinux.org/packages/nuclear-player-git              | [nukeop](https://github.com/nukeop)          | yay -S nuclear-player-git                     |

| Choco (Win)    | https://chocolatey.org/packages/nuclear/                           | [JourneyOver](https://github.com/JourneyOver)| choco install nuclear                         |

| GURU (Gentoo)  | https://github.com/gentoo/guru/tree/master/media-sound/nuclear-bin | Orphaned    | emerge nuclear-bin                            |

| Homebrew (Mac) | https://formulae.brew.sh/cask/nuclear                              | Homebrew                                     | brew install --cask nuclear                   |

| Snap           | https://snapcraft.io/nuclear                                       | [nukeop](https://github.com/nukeop)          | sudo snap install nuclear                     |

| Flatpak        | https://flathub.org/apps/details/org.js.nuclear.Nuclear            | [nukeop](https://github.com/nukeop)          | flatpak install flathub org.js.nuclear.Nuclear|

| Void Linux     | https://github.com/machadofguilherme/nuclear-template              | [machadofguilherme](https://github.com/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](https://crowdin.com/project/nuclear) to manage localization. You can check if your language is supported, track localization progress, and help us translate Nuclear there.



## Screenshots

This will be updated as the program evolves.



![Album Search](https://i.imgur.com/idFVnAF.png)



![Album Display](https://i.imgur.com/Kvzo3q7.png)



![Artist View](https://i.imgur.com/imBLYl3.png)



![Dashboard Best New Music](https://i.imgur.com/bMDrR4M.png)



![Dashboard Genres](https://i.imgur.com/g0aCmKx.png)



![Playlist View](https://i.imgur.com/2VMXHDC.png)



![Lyrics View](https://i.imgur.com/7e3DJKJ.png)



![Equalizer View](https://i.imgur.com/WreRL0w.png)



## License



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.



## Attributions

Uses SponsorBlock data licensed used under [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) from https://sponsor.ajay.app/.