nuclear
nukeop · nukeop/nuclear
Nuclear is a free, open-source streaming music player that finds and plays music, featuring an MCP server allowing AI agents to control playback.
Streaming music player that finds free music for you
See it in action
From the author's READMEMain dashboard showing top playlists, artists, and playback controls
From the author's README nukeop ·Source
What you can do with it
- Create an AI agent that manages your music queue and plays songs based on your mood or activity.
- Build an agent that can search for specific artists or albums and start playback on command.
- Develop a custom alarm or background music system controlled by an AI agent throughout your day.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
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, with light and a dark modes:
| Artist search | Album search |
| Track search with recent searches | Artist page |
| Album page | Favorites |
| Playlists | Playlist |
| Synced lyrics | Lyrics with furigana and translations |
| Listening history | Listening stats |
| Stream sources for a queued track | Plugin store |
| Installed plugins | Preferences |
| What's new | Log viewer |
Control Nuclear from your phone with Nuclear Jam:
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 various 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.