Nuclear
  • Nuclear Music Player
  • FAQ
  • User manual
    • Sources
    • Keyboard shortcuts
    • Importing playlists
    • How does Nuclear find the streams?
    • Stream verification
    • Telemetry
  • Developer resources
    • Development process
      • Building flatpak
    • Architecture
    • Plugin API
  • Contributing
    • Contribution guidelines
    • Converting to Typescript
    • Committing and resolving merge conflicts
    • Translating
Powered by GitBook
On this page
  • Importing from Spotify
  • From Deezer
  • From Youtube
  • From JSON File

Was this helpful?

  1. User manual

Importing playlists

PreviousKeyboard shortcutsNextHow does Nuclear find the streams?

Last updated 9 months ago

Was this helpful?

Nuclear is able to import playlists from Spotify and Youtube, it can also import editorials from Deezer (playlists made by Deezer).

Importing from Spotify

  1. Go to Playlists (on the left)

  2. Click Add, and then Import from Spotify:

  1. Paste your playlist's URL into the input box and click "Import"

  1. Nuclear will start importing the playlist you selected. Give it some time to do it. If it's less than a 100 tracks, it should be pretty much instant, with 500-100 it takes a couple of seconds. Nuclear will show that the playlist came from Spotify.

  1. You can now play the playlist. To save the playlist locally, use the Save locally button.

Afterwards, the playlist will be found in the Playlists section.

From Deezer

Nuclear displays the editorial playlists from Deezer in the Dashboard section.

Click the playlist you want to listen to. If you save it locally, you can then edit it:

From Youtube

  1. To get this link, you have to go to the playlist view on Youtube, not to a video in the playlist.

  2. If you're in a view where a video from the playlist is playing, and the rest of the playlist is in the sidebar, you can go directly to the playlist view by clicking its name:

  1. Paste the playlist link directly into Nuclear's search box. If you do it correctly, you should see a list of all the tracks in the playlist:

  1. Now you can add them all to your play queue, and save the queue as a playlist by clicking the three dots above the queue.

Youtube import is still being developed, and it will likely follow the same process as Spotify and Deezer in the future.

From JSON File

You can import a JSON playlist file with the following structure:

  {
    "name": "playlist name",
    "numberOfTrack": 105,
    "source": "youtube",
    "tracks": [
      {
        "index": 1,
        "id": "xxxxxx",
        "thumbnail": "image_url",
        "title": "track title",
        "album": "album name",
        "duration": "3:40",
        "artist": "artist name",
        "streams": [
          {
            "source": "youtube",
            "id": "xxxxxx"
          }
        ]
      },
    ]
  }
  • source and id fields help Nuclear pull streams correctly from stream provider.

  • streams field is only needed when you don't define the source field at the top level. This happens when the playlist is not from a single source.

The format of the URL should look like this:

You're going to need a playlist link that looks like this:

https://open.spotify.com/playlist/37i9dQZF1DWWQRwui0ExPn
https://www.youtube.com/playlist?list=PLWMjC05R8fbWlVwjhRx2E2jhdreZLr12c
Where the Import from Spotify button is located
Import dialog
Imported Spotify playlist
The editorial playlists from Deezer
Saving the Deezer playlist locally
Location of the playlist link
How to import a Youtube playlist
A Youtube screenshot showing where to click to go to the playlist view