GitHub - nukeop/nuclear: Streaming music player that finds free music for you

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 comes with multiple built-in themes:

Artist search Album search

Playlists Plugin store

Installed plugins Preferences

What's new Log viewer

Download

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

Platform Formats

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

• Discord

• Mastodon

• Discussions

License

AGPL-3.0. See LICENSE .

— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。