nukeop /nuclear
Streaming music player that finds free music for you
★ 18,951⑂ 1,358👁 163⑃ 1,025● 1,073▤ 92
+8
Daily
18,951
stars
1,358
forks
163
watchers
1,025
prs
1,073
issues
92
releases
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:
| | |
|:---:|:---:|
| !Search artists | !Search albums |
| Artist search | Album search |
| !Search tracks | !Artist page |
| Track search with recent searches | Artist page |
| !Album page | !Favorite artists |
| Album page | Favorites |
| !Playlists | !Playlist |
| Playlists | Playlist |
| !Synced lyrics | !Lyrics with furigana and translations |
| Synced lyrics | Lyrics with furigana and translations |
| !Listening history | !Listening stats |
| Listening history | Listening stats |
| !Stream sources | !Plugin store |
| Stream sources for a queued track | Plugin store |
| !Installed plugins | !Preferences |
| Installed plugins | Preferences |
| !What's new | !Log viewer |
| 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:
bash
claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp
Codex CLI:
bash
codex mcp add nuclear --url http://127.0.0.1:8800/mcp
OpenCode:
json
{
"mcp": {
"nuclear": {
"type": "remote",
"url": "http://127.0.0.1:8800/mcp"
}
}
}
Claude Desktop / Cursor / Windsurf:
json
{
"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 =Top issues
Discussions
#2257' <that symbol not working correctly (kugou lyric provider)1 comments · 2026-11-09#2256App freezes at startup with more than 20 playlists (Subsonic sync)0 comments · 2026-11-09#2254Song displays wrong title and plays previous song in playlist while using shuffle0 comments · 2026-11-08#2253Bug: App slows down when using lagoon theme1 comments · 2026-11-07#2252Prefer x86_64 over amd64 as architecture label in release builds1 comments · 2026-11-07#2243Bug: app crashing when browsing certain playlists1 comments · 2026-10-29#2240Queue stalls instead of skipping when a stream fails after retries0 comments · 2026-10-27#2237[BUG)Playback Error0 comments · 2026-10-26
Latest release
Nuclear Player v1.55.0 [email protected] 2026-11-13What's New in v1.55.0 - Improvement: Shuffle without repeats. Queue - @nukeop macOS: If the app won't open, run sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app in Terminal.