nuclear README

The project's README from github.com/nukeop/nuclear. As one markdown file: README.md.

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 artists Search albums
Artist search Album search
Playlists Plugin store
Playlists Plugin store
Installed plugins Preferences
Installed plugins Preferences
What's new Log viewer
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

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

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.

nuclear (nukeop/nuclear)

Searching Database…

18.7K ·GitHub
Nuclear
这是什么？Nuclear 是一款免费开源的桌面音乐播放器，能帮你找到免费音乐：搜索任意歌曲或歌手，直接播放，还能创建播放列表。
这是桌面应用，还是在浏览器里运行的？这是需要安装到你电脑上的原生桌面应用——当前版本用 Tauri 构建（Rust 后端加 React 界面），不是网页应用。
开始听歌需要注册账号或做额外设置吗？不需要——装好就能直接搜歌听歌，没有账号也没有订阅。只有从源码构建才需要额外工具：Node.js 22+、pnpm 9+ 和稳定版 Rust。
音乐是从哪里来的——有没有像 Spotify 那样的曲库？它围绕免费音乐构建：Nuclear 会搜索并播放来自各种来源的音乐，而不是出售某个授权曲库的访问权，所以能听到什么取决于它可用的音源。
它支持哪些平台？Windows、macOS 和 Linux——包括 Apple Silicon 和 Intel 芯片的 Mac。
它会追踪我或显示广告吗？不会——README 里写得明明白白：一款没有广告、不做追踪的音乐播放器，而且它是开源的，代码随时可以查看。
插件能做什么？能做的事很多——所有核心功能都由插件驱动。插件可以添加音源、元数据、播放列表和仪表盘内容；可以从内置的插件商店安装，也可以用 @nuclearplayer/plugin-sdk 自己编写。
我可以用 AI 智能体来控制播放器吗？可以——在“设置 → 集成”里启用 MCP 服务器，然后连接 Claude Code、Codex CLI、OpenCode、Claude Desktop、Cursor 或 Windsurf。这个 MCP 专为易于发现而设计，还有一个 Nuclear MCP Skill 可以让你的智能体快速上手。
除了搜索和播放，还有哪些功能？队列管理，支持随机播放、循环播放和拖拽排序；专辑、歌手和歌曲的收藏；播放列表的导入和导出，包括从其他服务导入；自动更新；键盘快捷键；多种界面语言；还有日志查看器。
可以自定义外观吗？可以——Nuclear 自带多款内置主题，还支持自定义 CSS 主题，你可以自己给播放器换风格。
What are similar projects?spotatui, openspot-music-app, Levyra-deepsound, Omarchy-Spotify, pear-desktop, spotube, spotify-tui, spotifast
Which topics is it in?spotify, mac, music-player, music, tauri, plugin-system, audio, agpl, streaming, sdk, mcp-server, plugin
Creator
nukeop
Size
219.9 MB
Stars
18.7K
Updated
CommitOct 16Release[email protected]Oct 16
Age
10y
Commits · 90 Days