Sandbox
@nukeop/nuclear

Desktop music player with plugins and MCP

Nuclear is a cross-platform desktop music player built with Tauri, React, Rust, and TypeScript. It can search for songs and artists, manage playlists and queues, and load plugins from a built-in store. It also exposes an MCP server so agents can drive the player.

18,423 stars1.3k forksTypeScriptUpdated 8d ago
Who it's for

Builders who want a desktop music player with plugin support and agent control.

What it delivers

You can listen to music from free sources and let an agent control the player through MCP.

What it does

Music search and streaming

Search for songs or artists and stream music from available sources.

Artist and album pages

Browse biographies, discographies, similar artists, and track listings.

Queue and playlist management

Use shuffle, repeat, drag-and-drop reordering, and playlist import or export.

Plugin system and store

Install plugins from the built-in store or write your own with @nuclearplayer/plugin-sdk.

MCP server

Enable the MCP server in Settings → Integrations and connect Claude Code, Codex, Cursor, or other clients.

Themes and localization

Use built-in themes, custom CSS themes, keyboard shortcuts, and multiple languages.

How to get it

  1. 1Run
    git clone https://github.com/nukeop/nuclear.git
    cd nuclear
    pnpm install
    pnpm dev

README

Nuclear Music Player

Nuclear

Nuclear is a free, open-source music player without ads or tracking. Search for any song or artist, build playlists, and start listening.
Runs on Windows, macOS, and Linux.

Screenshots

Nuclear Music Player - Dashboard

Nuclear comes with multiple built-in themes:

Green theme Aqua theme Mint theme

Orange theme Red theme Violet theme

Search artistsSearch albums
Artist searchAlbum search
PlaylistsPlugin store
PlaylistsPlugin store
Installed pluginsPreferences
Installed pluginsPreferences
What's newLog viewer
What's newLog viewer

Download

Grab the latest release for your platform from the Releases page.

PlatformFormats
Windows.exe installer, .msi
macOS.dmg (Apple Silicon and Intel)
Linux.AppImage, .deb, .rpm, .flatpak

Features

  • Search for music and stream it from any source
  • Browse artist pages with biographies, discographies, and similar artists
  • Browse album pages with track listings
  • Queue management with shuffle, repeat, and drag-and-drop reordering
  • Favorites (albums, artists, and tracks)
  • Playlists (create, import, export, import from varous services)
  • Powerful plugin system with a built-in plugin store
  • Themes (built-in and custom CSS themes)
  • MCP server lets your AI agent drive the player
  • Auto-updates
  • Keyboard shortcuts
  • Localized in multiple languages

Plugins

Nuclear has a powerful plugin system now! Every functionality has been redesigned to be driven by plugins.

Plugins can provide streaming sources, metadata, playlists, dashboard content, and more. Browse and install plugins from the built-in plugin store, or write your own using the @nuclearplayer/plugin-sdk.

MCP

You can enable the MCP server in Settings → Integrations.

Then to add it to Claude Code:

claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp

Codex CLI:

codex mcp add nuclear --url http://127.0.0.1:8800/mcp

OpenCode:

{
  "mcp": {
    "nuclear": {
      "type": "remote",
      "url": "http://127.0.0.1:8800/mcp"
    }
  }
}

Claude Desktop / Cursor / Windsurf:

{
  "mcpServers": {
    "nuclear": {
      "url": "http://127.0.0.1:8800/mcp"
    }
  }
}

The MCP is designed to be discoverable, but there's a skill you can load to get your AI up to speed: Nuclear MCP Skill

Development

Nuclear is a pnpm monorepo managed with Turborepo. The main app is built with Tauri (Rust + React).

Prerequisites

  • Node.js >= 22
  • pnpm >= 9
  • Rust (stable)
  • Platform-specific Tauri dependencies (see Tauri docs)

Getting started

git clone https://github.com/nukeop/nuclear.git
cd nuclear
pnpm install
pnpm dev

Useful commands

pnpm dev            # Run the player in dev mode
pnpm dev:remote     # Same, but binds Vite to 0.0.0.0 so you can open the remote control UI from other devices on your LAN
pnpm build          # Build all packages
pnpm test           # Run all tests
pnpm lint           # Lint all packages
pnpm type-check     # TypeScript checks
pnpm storybook      # Run Storybook

Community

License

AGPL-3.0. See LICENSE.

Files in the repo

Repository payload26 top-level entries
  • .agents
  • .github
  • .husky
  • .vscode
  • aur
  • flatpak
  • packages
  • snap
  • .gitattributes
  • .gitignore
  • .node-version
  • .prettierignore
  • AGENTS.md
  • codecov.yml
  • CONTRIBUTING.md
  • crowdin.yml
  • eslint.config.ts
  • LICENSE
  • package.json
  • pnpm-lock.yaml
  • pnpm-workspace.yaml
  • prettier.config.js
  • README.md
  • renovate.json
  • tsconfig.json
  • turbo.json

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More other

🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes, landing pages, dashboards, slides, images & video — real files, HTML/PDF/PPTX/MP4 export. 🤖 Claude Code / Codex / Cursor / DeepSeek Harness / OpenCode & 20+ CLIs via BYOK.

95k
HKUDS/
Vibe-Trading

"Vibe-Trading: Your Personal Trading Agent"

33k
tinyhumansai/
openhuman

OpenHuman is an open source personal AI for Mac, Windows and Linux — local-first memory, agent orchestration, and deep research.

40k

Your Personal AI Assistant; easy to install, deploy on your own machine or on the cloud; supports multiple chat apps with easily extensible capabilities.

35k