explaingit

nukeop/nuclear

Analysis updated 2026-06-24

17,603TypeScriptAudience · generalComplexity · 3/5LicenseSetup · easy

TLDR

Nuclear is a free open-source desktop music player that streams tracks from public sources, with playlists, themes, plugins, and an MCP server for AI control.

Mindmap

mindmap
  root((nuclear))
    Inputs
      Search queries
      Plugins
      Custom CSS themes
    Outputs
      Streamed audio
      Playlists
      Artist pages
    Use Cases
      Replace Spotify
      Build music plugins
      Control via AI
      Theme a music app
    Tech Stack
      TypeScript
      Tauri
      Rust
      MCP
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a free desktop music player with no ads or subscription.

USE CASE 2

Write a Nuclear plugin that adds a new streaming source.

USE CASE 3

Connect Claude or Cursor via MCP to control music playback.

USE CASE 4

Theme the player with custom CSS for a personalized look.

What is it built with?

TypeScriptTauriRustMCP

How does it compare?

nukeop/nuclearcopytranslator/copytranslatorredwoodjs/graphql
Stars17,60317,59017,617
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity3/52/53/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Streams rely on third-party sources which may break or vary by region.

AGPL-3.0 lets you use and modify the app freely, but any fork or service you build on it must also be released under AGPL-3.0.

In plain English

Nuclear is a free, open-source desktop music player that streams music without ads or tracking. Instead of requiring you to pay for a subscription or own music files, it searches for songs and streams them from available sources when you press play. You can search for artists or albums, build playlists, browse artist pages with biographies and discographies, and manage a playback queue with shuffle and repeat options. The app runs on Windows, macOS, and Linux, and comes with multiple built-in visual themes as well as support for custom CSS themes if you want to design your own look. A plugin system allows extra functionality to be added, plugins can provide different streaming sources, metadata (information about songs and artists), playlist formats, and dashboard content. There is a built-in plugin store where you can browse and install community-made plugins. A notable feature is an MCP (Model Context Protocol) server built into the player. MCP is a standard that lets AI assistants control external tools. With this enabled, you can connect an AI coding tool like Claude or Cursor to Nuclear and have it control playback, for example, asking your AI assistant to play a specific song or skip tracks while you work. The application is built with TypeScript using Tauri (a framework for building desktop apps with Rust for the backend and a web interface for the frontend). Nuclear is licensed under AGPL-3.0, a free and open-source license that requires derivative works to also be open source.

Copy-paste prompts

Prompt 1
Install Nuclear on macOS and walk me through building my first playlist from search results.
Prompt 2
Write a Nuclear plugin in TypeScript that adds Bandcamp as a streaming source.
Prompt 3
Set up the Nuclear MCP server and connect it to Claude Desktop so I can ask it to play songs.
Prompt 4
Create a custom CSS theme for Nuclear that mimics the Spotify dark UI.
Prompt 5
Compare Nuclear to other free music players like Strawberry and Lollypop for daily desktop use.

Frequently asked questions

What is nuclear?

Nuclear is a free open-source desktop music player that streams tracks from public sources, with playlists, themes, plugins, and an MCP server for AI control.

What language is nuclear written in?

Mainly TypeScript. The stack also includes TypeScript, Tauri, Rust.

What license does nuclear use?

AGPL-3.0 lets you use and modify the app freely, but any fork or service you build on it must also be released under AGPL-3.0.

How hard is nuclear to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is nuclear for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub nukeop on gitmyhub

Verify against the repo before relying on details.