</p>
How to install nuclear?
nukeop/nuclear
$git clone https://github.com/nukeop/nuclearInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install nuclear by running `git clone https://github.com/nukeop/nuclear`, then use it for the current task and follow its documentation at https://github.com/nukeop/nuclear.
README.md
| 1 | <p align="center"> |
| 2 | <picture> |
| 3 | <source alt="Nuclear Music Player" srcset="packages/docs/.gitbook/assets/readme-banner.png"> |
| 4 | <img alt="Nuclear Music Player" srcset="packages/docs/.gitbook/assets/readme-banner.png"> |
| 5 | </picture> |
| 6 | |
| 7 | |
| 8 | </p> |
| 9 | |
| 10 | <div align="center"> |
| 11 | |
| 12 | # Nuclear |
| 13 | |
| 14 | </div> |
| 15 | |
| 16 | <div align="center"> |
| 17 | |
| 18 | Nuclear is a free, open-source music player without ads or tracking. Search for any song or artist, build playlists, and start listening.<br> |
| 19 | Runs on Windows, macOS, and Linux. |
| 20 | |
| 21 | </div> |
| 22 | |
| 23 | ## Screenshots |
| 24 | |
| 25 | <p align="center"> |
| 26 | <img src="packages/docs/.gitbook/assets/dashboard-main.png" alt="Nuclear Music Player - Dashboard" width="100%"> |
| 27 | </p> |
| 28 | |
| 29 | Nuclear comes with multiple built-in themes: |
| 30 | |
| 31 | <p align="center"> |
| 32 | <img src="packages/docs/.gitbook/assets/dashboard-green.png" alt="Green theme" width="32%"> |
| 33 | <img src="packages/docs/.gitbook/assets/dashboard-aqua.png" alt="Aqua theme" width="32%"> |
| 34 | <img src="packages/docs/.gitbook/assets/dashboard-mint.png" alt="Mint theme" width="32%"> |
| 35 | </p> |
| 36 | <p align="center"> |
| 37 | <img src="packages/docs/.gitbook/assets/dashboard-orange.png" alt="Orange theme" width="32%"> |
| 38 | <img src="packages/docs/.gitbook/assets/dashboard-red.png" alt="Red theme" width="32%"> |
| 39 | <img src="packages/docs/.gitbook/assets/dashboard-violet.png" alt="Violet theme" width="32%"> |
| 40 | </p> |
| 41 | |
| 42 | | | | |
| 43 | |:---:|:---:| |
| 44 | |  |  | |
| 45 | | Artist search | Album search | |
| 46 | |  |  | |
| 47 | | Playlists | Plugin store | |
| 48 | |  |  | |
| 49 | | Installed plugins | Preferences | |
| 50 | |  |  | |
| 51 | | What's new | Log viewer | |
| 52 | |
| 53 | ## Download |
| 54 | |
| 55 | Grab the latest release for your platform from the [Releases page](https://github.com/nukeop/nuclear/releases). |
| 56 | |
| 57 | | Platform | Formats | |
| 58 | |----------|---------| |
| 59 | | Windows | `.exe` installer, `.msi` | |
| 60 | | macOS | `.dmg` (Apple Silicon and Intel) | |
| 61 | | Linux | `.AppImage`, `.deb`, `.rpm`, `.flatpak` | |
| 62 | |
| 63 | ## Features |
| 64 | |
| 65 | - Search for music and stream it from any source |
| 66 | - Browse artist pages with biographies, discographies, and similar artists |
| 67 | - Browse album pages with track listings |
| 68 | - Queue management with shuffle, repeat, and drag-and-drop reordering |
| 69 | - Favorites (albums, artists, and tracks) |
| 70 | - Playlists (create, import, export, import from varous services) |
| 71 | - Powerful plugin system with a built-in plugin store |
| 72 | - Themes (built-in and custom CSS themes) |
| 73 | - MCP server lets your AI agent drive the player |
| 74 | - Auto-updates |
| 75 | - Keyboard shortcuts |
| 76 | - Localized in multiple languages |
| 77 | |
| 78 | ## Plugins |
| 79 | |
| 80 | Nuclear has a powerful plugin system now! Every functionality has been redesigned to be driven by plugins. |
| 81 | |
| 82 | 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](https://www.npmjs.com/package/@nuclearplayer/plugin-sdk). |
| 83 | |
| 84 | ## MCP |
| 85 | |
| 86 | You can enable the MCP server in Settings → Integrations. |
| 87 | |
| 88 | Then to add it to **Claude Code:** |
| 89 | |
| 90 | ```bash |
| 91 | claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp |
| 92 | ``` |
| 93 | |
| 94 | **Codex CLI:** |
| 95 | |
| 96 | ```bash |
| 97 | codex mcp add nuclear --url http://127.0.0.1:8800/mcp |
| 98 | ``` |
| 99 | |
| 100 | **OpenCode:** |
| 101 | |
| 102 | ```json |
| 103 | { |
| 104 | "mcp": { |
| 105 | "nuclear": { |
| 106 | "type": "remote", |
| 107 | "url": "http://127.0.0.1:8800/mcp" |
| 108 | } |
| 109 | } |
| 110 | } |
| 111 | ``` |
| 112 | |
| 113 | **Claude Desktop / Cursor / Windsurf:** |
| 114 | |
| 115 | ```json |
| 116 | { |
| 117 | "mcpServers": { |
| 118 | "nuclear": { |
| 119 | "url": "http://127.0.0.1:8800/mcp" |
| 120 | } |
| 121 | } |
| 122 | } |
| 123 | ``` |
| 124 | |
| 125 | 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](./packages/docs/public/skills/nuclear-mcp.zip) |
| 126 | |
| 127 | ## Development |
| 128 | |
| 129 | Nuclear is a |
Related
6 picksType
- ha-mcpComprehensive Model Context Protocol server for managing Home Assistant through AI assistants.Jul 2026
- google_workspace_mcpGoogle Workspace MCP server for Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Chat.Jul 2026
- basic-memoryLocal-first knowledge management with bi-directional LLM sync via Markdown files.Jul 2026
- voicemodeNatural voice conversations for AI assistants - STT/TTS via MCPJul 2026
- mcp-server-calculatorA Model Context Protocol server for calculatingMay 2025
- email-mcpIMAP/SMTP email MCP server — 47 tools, IMAP IDLE push, multi-account, AI triage.May 2026
