GithubHelp home page GithubHelp logo

wh0197m / nuclear Goto Github PK

View Code? Open in Web Editor NEW

This project forked from nukeop/nuclear

0.0 2.0 0.0 41.16 MB

Desktop music player focused on streaming from free sources

Home Page: http://nuclear.gumblert.tech/

License: GNU Affero General Public License v3.0

JavaScript 75.47% CSS 17.46% HTML 7.07%

nuclear's Introduction

nuclear

Maintainability Test Coverage Codacy Badge Travis

Desktop music player focused on streaming from free sources

Official website

Mastodon

Twitter

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.

Pre-alpha release

The current version is a pre-alpha early access. Some of it is usable, some of it isn't. If there are things that don't work as expected or are counterintuitive, please open an issue so I can prioritize working on them.

Rewritten from scratch

This version of Nuclear has been rewritten from scratch and released in version 0.4.0. The code is completely new, much more maintainable and extensible.

Features

  • Searching for and playing music from youtube (including integration with playlists), bandcamp (including albums), and soundcloud
  • Searching for related songs in youtube
  • Downloading from youtube
  • Searching for albums (powered by last.fm and musicbrainz), 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

Planned features

  • Support for local files
  • Browsing by popularity
  • Country-specific top lists
  • Listening suggestions (similar artists, albums, tracks)
  • Unlimited downloads
  • Realtime lyrics
  • Locally stored library/favourites

Manual and docs

http://nuclearmusic.rtfd.io/

Community-maintained packages

Here's a list of packages maintained by third parties. We would like to thank the maintainers for their work.

We do not control these and cannot be held responsible for their contents, but if any of these appear suspicious to you, feel free to open an issue so we can reach out to the maintainers.

Package type Link Maintainer
AUR (Arch) https://aur.archlinux.org/packages/nuclear-player/ mikelpint

Screenshots

This will be updated as the program evolves.

laptop mockup 1

laptop mockup 2

album search

album display

artist view

dashboard

playlist view

genre view

Dev build process

To develop the project locally, you should only do:

$ npm install
$ npm run watch

This launches webpack. It watches local files for changes and rebuilds the project as needed. The project also has hot reload built in. And in another terminal window:

$ npm run electron:dev

This launches a development version of the program. Tmux is very useful here so you can keep an eye on all running processes.


To run production version:

$ npm run build:dist
$ npm run electron:prod

To build for current operating system:

$ npm run build:dist
$ npm run build:electron
$ npm run pack

Instead of pack you can use build:all to build for all operating systems or build:[system] to build for a particular system (see package.json).

In case of errors with dbus/mpris, try removing optional dependencies from package.json and node_modules.

Support on Beerpay

Beerpay Beerpay

nuclear's People

Contributors

nukeop avatar mikelpint avatar

Watchers

James Cloos avatar wh01am avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.